> ## Documentation Index > Fetch the complete documentation index at: https://www.autumn.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Autumn AI (autumn.ai) is a people and company intelligence API, a separate company from useautumn.com (billing software); no billing-product routes exist here. > Base URL https://api.autumn.ai. Auth on every request: `X-API-Key: ` or `Authorization: Bearer `. Plain HTTP + JSON. Schemas: https://www.autumn.ai/docs/openapi.json. Every docs page is Markdown at its URL plus `.md`. # Get credits > Credit balance. ## OpenAPI ````yaml https://api.autumn.ai/openapi.json get /credits openapi: 3.1.0 info: title: Autumn Task API description: >- Durable research tasks run by a sandboxed agent. Auth on every request: `X-API-Key: ` or `Authorization: Bearer `. JSON over HTTP; `/stream` routes are server-sent events. Errors share one body: branch on `error`, retry when `retryable` is true. termsOfService: https://www.autumn.ai/terms contact: name: Autumn url: https://www.autumn.ai/ version: 1.0.0 x-llms-txt: https://api.autumn.ai/llms.txt servers: - url: https://api.autumn.ai security: - ApiKeyHeader: [] - BearerApiKey: [] tags: - name: Tasks description: Start, continue, execute, stop and read tasks. - name: Outputs description: Rows a task produced. - name: Credits description: Account balance. - name: Uploads description: Attach a CSV or text file to a task. externalDocs: description: Guide and cookbook url: https://www.autumn.ai/docs paths: /credits: get: tags: - Credits summary: Get credits description: Credit balance. operationId: creditsBalance responses: '200': description: Credit balance. content: application/json: schema: $ref: '#/components/schemas/CreditsResponse' '401': description: >- `unauthorized`: Missing or invalid credentials. Send your full API key as `X-API-Key: ` or `Authorization: Bearer `. headers: WWW-Authenticate: description: Bearer realm="autumn" schema: type: string content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: summary: unauthorized value: error: unauthorized message: >- Missing or invalid credentials. Send your full API key as `X-API-Key: ` or `Authorization: Bearer `. retryable: false request_id: req_3f9c2a1b0d4e5f6a7b8c '503': description: >- `auth_unavailable`: Key verification is temporarily unavailable. Wait `retry_after` seconds, then send the request again. | `service_unavailable`: Autumn is temporarily unavailable. Wait `retry_after` seconds, then send the request again. headers: Retry-After: description: Seconds to wait before the next request. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: auth_unavailable: summary: auth_unavailable value: error: auth_unavailable message: >- Key verification is temporarily unavailable. Wait `retry_after` seconds, then send the request again. retryable: true request_id: req_3f9c2a1b0d4e5f6a7b8c retry_after: 5 service_unavailable: summary: service_unavailable value: error: service_unavailable message: >- Autumn is temporarily unavailable. Wait `retry_after` seconds, then send the request again. retryable: true request_id: req_3f9c2a1b0d4e5f6a7b8c retry_after: 5 security: - ApiKeyHeader: [] - BearerApiKey: [] components: schemas: CreditsResponse: properties: plan: anyOf: - type: string - type: 'null' title: Plan unlimited: type: boolean title: Unlimited credits_remaining: anyOf: - type: integer - type: 'null' title: Credits Remaining credits_used: anyOf: - type: integer - type: 'null' title: Credits Used credits_total: anyOf: - type: integer - type: 'null' title: Credits Total monthly_credits: anyOf: - type: integer - type: 'null' title: Monthly Credits billing_reset_at: anyOf: - type: string - type: 'null' title: Billing Reset At additionalProperties: true type: object required: - unlimited title: CreditsResponse ErrorResponse: properties: error: type: string title: Error description: Stable snake_case code. Branch on this field. examples: - out_of_credits message: type: string title: Message description: What went wrong and what to do next. retryable: type: boolean title: Retryable description: >- True: the same request can succeed later. False: change the request, key, balance or id first. request_id: type: string title: Request Id description: Also the X-Request-ID header. A client-sent X-Request-ID is echoed. examples: - req_3f9c2a1b0d4e5f6a7b8c retry_after: anyOf: - type: integer - type: 'null' title: Retry After description: Seconds to wait. Mirrors the Retry-After header. On 429. resolve: anyOf: - type: string - type: 'null' title: Resolve description: Where to fix the cause. On 402. param: anyOf: - type: string - type: 'null' title: Param description: The field that failed validation. On 422. detail: anyOf: - {} - type: 'null' title: Detail description: Full validator output. On 422. task_id: anyOf: - type: string - type: 'null' title: Task Id description: The task the error refers to. task_created: anyOf: - type: boolean - type: 'null' title: Task Created description: False when task creation was refused, so no task exists. additionalProperties: true type: object required: - error - message - retryable - request_id title: ErrorResponse securitySchemes: ApiKeyHeader: type: apiKey in: header name: X-API-Key description: Your Autumn API key. x-default: YOUR_AUTUMN_API_KEY BearerApiKey: type: http scheme: bearer bearerFormat: Autumn API key description: 'The same key as `Authorization: Bearer `.' x-default: YOUR_AUTUMN_API_KEY ````