> ## Documentation Index > Fetch the complete documentation index at: https://docs.creao.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get account usage > Read the calling account's credit balance and 24h API spend. ## OpenAPI ````yaml /developer-api/developer-v1.openapi.yaml get /v1/account/usage openapi: 3.1.0 info: title: CREAO Developer API version: 1.0.0 description: | Create, update, and run personal CREAO agents from your backend with Account API keys. The v1 API uses stable `agent_id`, `conversation_id`, and `run_id` identifiers and is served from `developer.creao.ai`. servers: - url: https://developer.creao.ai description: Production security: - bearerAuth: [] - apiKeyQuery: [] tags: - name: Agents description: >- Create, list, get, update, and edit personal agents for the authenticated account. - name: Agent Memory description: >- Read, overwrite, and clear long-term memory (playbooks) for a personal agent. - name: Agent Files description: List, download, and delete files in a personal agent's skill file space. - name: Product Profile description: Once-per-account Super Agent persona and brand context. - name: Agent Runs description: >- Create, stream, fetch, and list runs for created personal agents. Super Agent rows are excluded. - name: Super Agent description: >- Chat with CREAO Super Agent from your backend. Same public NDJSON render protocol as Agent Runs. Requires an allowlisted account. - name: Account description: >- Read the calling account's platform-wallet balance and Developer API spend. - name: Models description: Discover supported model ids and account-specific availability. - name: Workspaces description: Create and list personal workspaces, and add or remove personal agents. - name: Workspace Files description: Upload, list, download, and delete files in a personal workspace. - name: Secrets description: Add, update, and list account secret keys. Values are write-only. - name: Skills description: Install, list, and enable account-level Agent Brain skills. paths: /v1/account/usage: get: tags: - Account summary: Get account usage description: > Return the calling account's platform-wallet balance and rolling 24-hour Developer API spend. `credits.available` is the CREAO platform wallet in display credits (the same number Developer Console shows). `credits.used_24h` and `requests_24h` sum `developer_api_http_requests` for the last 24 hours — reported API spend, not a dump of `credit_deduction_logs`. `hourly_cap_exceeded` is true when the wallet is blocked by the hourly spend cap even if `available` is still greater than zero. Any Account API key can call this route. It is not Super Agent allowlist-gated. Counts against the account read budget. operationId: getAccountUsage responses: '200': description: Account usage for the Account key owner. content: application/json: schema: $ref: '#/components/schemas/AccountUsage' examples: fundedAccount: value: plan: pro credits: available: 1234.56 used_24h: 18.2 requests_24h: 42 hourly_cap_exceeded: false '401': $ref: '#/components/responses/AuthenticationRequired' '429': $ref: '#/components/responses/RateLimited' components: schemas: AccountUsage: type: object additionalProperties: false required: - plan - credits - requests_24h - hourly_cap_exceeded properties: plan: type: string description: CREAO plan slug for the Account key owner. credits: type: object additionalProperties: false required: - available - used_24h properties: available: type: number description: >- Remaining platform-wallet credits for the Account key owner (display units). Source of truth for whether new runs can start. used_24h: type: number description: >- Credits attributed to Developer API HTTP requests in the last 24 hours. Not the billing ledger. requests_24h: type: integer minimum: 0 description: Developer API HTTP requests in the last 24 hours. hourly_cap_exceeded: type: boolean description: >- True when the account is blocked by the hourly spend cap even if `credits.available` is still greater than zero. ErrorResponse: type: object additionalProperties: true required: - error properties: error: type: string description: Stable machine-readable error code. message: type: string description: Debug message. Do not rely on this field in production clients. available: type: number description: Available credits, when returned for credit errors. required: type: number description: Required credits, when returned for credit errors. retryAfterSeconds: type: integer description: Retry delay, when returned for hourly cap errors. responses: AuthenticationRequired: description: Missing, malformed, revoked, or unknown Account API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missingKey: value: error: AUTHENTICATION_REQUIRED RateLimited: description: Account-level or IP-level rate limit exceeded. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rateLimited: value: error: RATE_LIMITED securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: cr_sk description: Account API key from Developer Console. Keys start with `cr_sk_`. x-default: cr_sk_your_key_here apiKeyQuery: type: apiKey in: query name: creao-api-key description: | Account API key passed as a query parameter, for platforms that cannot set a custom Authorization header. The bearerAuth header takes precedence when both are present. x-default: cr_sk_your_key_here ````