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

# Look up your current credit balance

> Free — does not spend credits. Requires a valid `Authorization: Bearer <key>` header.



## OpenAPI

````yaml /horizon/openapi.json get /v1/usage
openapi: 3.1.0
info:
  title: Horizon API
  version: '1.0'
  description: >-
    Horizon is a prepaid-credits REST API for LinkedIn/company enrichment, email
    finding and verification, job search, and web search. Every request
    authenticates with an `Authorization: Bearer <key>` header and, on a billed
    endpoint, debits a fixed number of credits from your prepaid balance (see
    each endpoint's description for its exact cost). Check your balance any time
    with GET /v1/usage.
servers:
  - url: https://horizon.gravitygtm.com/api
security:
  - bearerAuth: []
paths:
  /v1/usage:
    get:
      tags:
        - usage
      summary: Look up your current credit balance
      description: >-
        Free — does not spend credits. Requires a valid `Authorization: Bearer
        <key>` header.
      responses:
        '200':
          description: 200 — current balance.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tenantId:
                    type: string
                  credits_remaining:
                    type: number
                required:
                  - tenantId
                  - credits_remaining
        '401':
          description: >-
            401 unauthorized — missing or invalid `Authorization: Bearer <key>`
            header.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - unauthorized
                  message:
                    type: string
                required:
                  - error
                  - message
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````