Skip to main content
GET
/
credits
/
usage
Get credit usage
curl --request GET \
  --url https://julian.11x.ai/api/v1/credits/usage \
  --header 'x-api-key: <api-key>'
{
  "period": {
    "startDate": "2023-12-25",
    "endDate": "2023-12-25",
    "month": "2026-05"
  },
  "organization": {
    "allocatedCredits": 123,
    "spentCredits": 123,
    "remainingCredits": 123,
    "percentageUsed": 123
  },
  "agents": [
    {
      "agentId": "<string>",
      "agentName": "<string>",
      "spentCredits": 123,
      "transactionCount": 123
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Organization API key. Get it from the 11x team or from the platform.

Query Parameters

​
month
string

Billing month as YYYY-MM. Defaults to the current month. Must not be in the future. Mutually exclusive with startDate/endDate.

Pattern: ^\d{4}-\d{2}$
Example:

"2026-05"

​
startDate
string<date>

Start of a custom range as YYYY-MM-DD (inclusive, UTC). Requires endDate. Range cannot exceed 366 days.

​
endDate
string<date>

End of a custom range as YYYY-MM-DD (inclusive, UTC). Requires startDate. Cannot be in the future.

Response

Credit usage report.

​
period
object
required

Echo of the resolved reporting period. month is present in month mode only.

​
organization
object
required
​
agents
object[]
required

Per-agent consumption breakdown from the credit ledger.