> ## 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 AI credit usage by flow

> One row per Agent Studio flow (and one, Stella (PPT), for presentations made in chat), with its billed calls and credits, most credits first, then by name. 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.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/credits/flows
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/flows:
    get:
      tags:
        - credits
      summary: List AI credit usage by flow
      description: >-
        One row per Agent Studio flow (and one, Stella (PPT), for presentations
        made in chat), with its billed calls and credits, most credits first,
        then by name. 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.
      operationId: credits_flows
      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/FlowUsagePage'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    FlowUsagePage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/FlowUsage'
          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: FlowUsagePage
      type: object
    FlowUsage:
      properties:
        credits:
          description: The credits the calls used
          title: Credits
          type: number
        name:
          description: >-
            The Agent Studio flow, or Stella (PPT) for presentations made in
            chat
          title: Name
          type: string
        runs:
          description: The billed calls in the period
          title: Runs
          type: integer
        tiers:
          description: The credit tiers the flow's calls used, such as [1, 2]
          items:
            type: integer
          title: Tiers
          type: array
      required:
        - name
        - tiers
        - runs
        - credits
      title: FlowUsage
      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.