> ## Documentation Index
> Fetch the complete documentation index at: https://help.statisfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List the AI credit usage log

> Every AI call, newest first: its tier and credits, and the flow run or the person (by id) that made it. Covers the current contract period, as the app's AI Usage page does (all usage when Statisfy has not set up your contract yet). `limit` is up to 100. The prompt and the answer of a call are not listed.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/credits/log
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/credits/log:
    get:
      tags:
        - credits
      summary: List the AI credit usage log
      description: >-
        Every AI call, newest first: its tier and credits, and the flow run or
        the person (by id) that made it. Covers the current contract period, as
        the app's AI Usage page does (all usage when Statisfy has not set up
        your contract yet). `limit` is up to 100. The prompt and the answer of a
        call are not listed.
      operationId: credits_log
      parameters:
        - in: query
          name: limit
          required: false
          schema:
            default: 20
            maximum: 100
            minimum: 1
            type: integer
        - description: '`next_cursor` from the previous page'
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: null
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageLogPage'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    UsageLogPage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/UsageLogEntry'
          title: Data
          type: array
        has_more:
          default: false
          title: Has More
          type: boolean
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      required:
        - data
      title: UsageLogPage
      type: object
    UsageLogEntry:
      properties:
        credits:
          anyOf:
            - type: number
            - type: 'null'
          description: The credits the call used; null when it is not billed (not 0)
          title: Credits
        date:
          description: When the call was made
          format: date-time
          title: Date
          type: string
        flow:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The Agent Studio flow that made the call; null for a call made in
            chat
          title: Flow
        id:
          title: Id
          type: integer
        person:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The id of the person who made a call in chat (never their name or
            email); null for a flow call
          title: Person
        run_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: The flow run, to group a run's calls; null for a call made in chat
          title: Run Id
        tier:
          anyOf:
            - type: integer
            - type: 'null'
          description: The credit tier; null when the call is not billed
          title: Tier
        use_case:
          anyOf:
            - type: string
            - type: 'null'
          description: What the call was for, such as langflow.llm
          title: Use Case
      required:
        - id
        - date
        - use_case
        - tier
        - credits
        - flow
        - run_id
        - person
      title: UsageLogEntry
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.