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.
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.
Length
1 <= lengthResponse 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"
}