GET/api/v1/credits

Get the organization credit balance

OpenRouter's credits shape for the organization that owns the key. Both figures are USD; total_credits - total_usage is the current wallet balance. Any key of the organization may call it.

Authentication: Bearer API key in the Authorization header

Responses

  • 200

    The credit balance.

    Response
    • dataobjectrequired
      data
      • total_creditsnumberrequired

        Every grant and top-up to date, USD.

      • total_usagenumberrequired

        What has drawn the grants down, USD.

  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The resource does not exist or belongs to another organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

Request

curl https://api.experientiallabs.ai/api/v1/credits \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": {
    "total_credits": 125,
    "total_usage": 41.372915
  }
}

https://api.experientiallabs.ai/api/v1/credits