AdnovaDocs
Manage

Get API credit usage

Returns the organization's Inspiration ad-credit usage for its current billing period — credits used, credits remaining, the total limit, the period window, and the reset date. Ad-returning Inspiration and Following Brands endpoints consume 1 credit per ad returned. Use this endpoint to monitor consumption and the remaining balance. The organization is taken from the x-org-id header.

GET
/api_credits/usage

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Header Parameters

x-org-id*string

Organization to report credit usage for. Get this from List organizations.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/manage/v1/api_credits/usage" \  -H "x-org-id: string"
{
  "creditsUsed": 1250,
  "creditsRemaining": 8750,
  "creditsLimit": 10000,
  "period": {
    "start": "2026-05-18T00:00:00.000Z",
    "end": "2026-06-18T00:00:00.000Z"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}