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

# Get API account usage and spend summary



## OpenAPI

````yaml https://api.batchrelay.com/openapi.json get /v1/usage
openapi: 3.1.0
info:
  title: Batch Relay API
  version: 1.0.0
  description: >-
    Provider-neutral print catalog and prepared-media validation. This document
    covers only routes owned by the Go service; it deliberately excludes
    migration-proxied order lifecycle routes and all provider payloads.
servers:
  - url: https://api.batchrelay.com
security: []
tags:
  - name: System
  - name: Catalog
  - name: Print orders
  - name: Managed assets
  - name: Template renders
  - name: API accounts
paths:
  /v1/usage:
    get:
      tags:
        - API accounts
      summary: Get API account usage and spend summary
      operationId: getAPIUsage
      responses:
        '200':
          description: Account-scoped usage
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIUsage'
        '401':
          $ref: '#/components/responses/APIKeyAuthenticationRequired'
        '403':
          $ref: '#/components/responses/APIKeyForbidden'
        '503':
          $ref: '#/components/responses/StatefulAPIUnavailable'
components:
  schemas:
    APIUsage:
      type: object
      required:
        - request_count
        - order_count
        - spend_cents
        - currency
      properties:
        request_count:
          type: integer
          minimum: 0
        order_count:
          type: integer
          minimum: 0
        spend_cents:
          type: integer
          minimum: 0
        currency:
          type: string
          const: USD
      additionalProperties: false
    Error:
      type: object
      required:
        - error
        - code
        - message
        - docs_url
        - request_id
      properties:
        error:
          type: string
          description: Backward-compatible human-readable error.
        code:
          type: string
          description: Stable machine-readable error code.
        message:
          type: string
        docs_url:
          type: string
          format: uri
        request_id:
          type: string
      additionalProperties: false
  responses:
    APIKeyAuthenticationRequired:
      description: A valid Batch Relay API key is required.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    APIKeyForbidden:
      description: The API key cannot perform this operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    StatefulAPIUnavailable:
      description: >-
        The stateful order service is not configured or is temporarily
        unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'

````