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

# Get Usage By Member

> Current cap-cycle usage broken down by member across the billing
account's organisations (billing admins only). Usage with no member
(background jobs) is reported as an unattributed bucket so the totals
reconcile. Same monthly window as the enforced cap.



## OpenAPI

````yaml https://api.truestate.io/openapi.json get /credits/usage-by-member/
openapi: 3.1.0
info:
  title: TrueState Backend API
  summary: >-
    TrueState is an AI platform for business users to create high-impact AI
    solutions.
  description: >

    This **[TrueState](https://www.truestate.io/)** backend API allows our
    clients to automate and more powerfully retrieve and modify data from the
    TrueState platform.


    Example use cases include:


    - Accessing embeddings for a dataset.

    - Automating the process of dataset creation and model retraining as your
    data changes.

    - Much more.


    Our backend is built using the [FastAPI](https://fastapi.tiangolo.com/)
    framework in python

    using [Auth0](https://auth0.com/) and [Client API
    Keys](https://www.truestate.io/dawn/docs) for internal an external
    authentication, respectively.

    Our backend is designed to be secure, scalable, easy to use and well
    documented _(each router with its own linked docs page)_.

    Clients can only access data from their own organisation, as setup in Auth0
    our the Client API Keys. See how
    **[here](https://www.truestate.io/dawn/docs)**.


    **PS**: You can view this API documentation in either
    **[Swagger](swagger/docs)** or **[Redoc](redoc/)**, but only the swagger
    lets you test calls.
  contact:
    name: True State Support
    url: https://www.truestate.io/dawn/docs
    email: support@truestate.io
  license:
    name: Private
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 0.13.95
servers: []
security: []
paths:
  /credits/usage-by-member/:
    get:
      tags:
        - credit-usage
      summary: Get Usage By Member
      description: |-
        Current cap-cycle usage broken down by member across the billing
        account's organisations (billing admins only). Usage with no member
        (background jobs) is reported as an unattributed bucket so the totals
        reconcile. Same monthly window as the enforced cap.
      operationId: get_usage_by_member_credits_usage_by_member__get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemberUsageBreakdown'
        '404':
          description: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    MemberUsageBreakdown:
      properties:
        period_start:
          type: string
          title: Period Start
        members:
          items:
            $ref: '#/components/schemas/MemberUsageRow'
          type: array
          title: Members
        attributed_total_usd:
          type: number
          title: Attributed Total Usd
        unattributed_ai_usd:
          type: number
          title: Unattributed Ai Usd
        unattributed_infrastructure_usd:
          type: number
          title: Unattributed Infrastructure Usd
        unattributed_usd:
          type: number
          title: Unattributed Usd
        total_ai_usd:
          type: number
          title: Total Ai Usd
        total_infrastructure_usd:
          type: number
          title: Total Infrastructure Usd
        total_usd:
          type: number
          title: Total Usd
      type: object
      required:
        - period_start
        - members
        - attributed_total_usd
        - unattributed_ai_usd
        - unattributed_infrastructure_usd
        - unattributed_usd
        - total_ai_usd
        - total_infrastructure_usd
        - total_usd
      title: MemberUsageBreakdown
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    MemberUsageRow:
      properties:
        member_id:
          type: string
          title: Member Id
        user_id:
          type: string
          title: User Id
        user_name:
          anyOf:
            - type: string
            - type: 'null'
          title: User Name
        user_email:
          anyOf:
            - type: string
            - type: 'null'
          title: User Email
        organisation_id:
          type: string
          title: Organisation Id
        organisation_name:
          type: string
          title: Organisation Name
        ai_usd:
          type: number
          title: Ai Usd
        infrastructure_usd:
          type: number
          title: Infrastructure Usd
        total_usd:
          type: number
          title: Total Usd
      type: object
      required:
        - member_id
        - user_id
        - user_name
        - user_email
        - organisation_id
        - organisation_name
        - ai_usd
        - infrastructure_usd
        - total_usd
      title: MemberUsageRow
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````