Get account usage
Account-backed diagnostics do not debit minute/month allowance. A separate 30-per-minute account diagnostic limit applies, including when paid quota is exhausted.
/v1/usageLocal anonymous and single-key modes do not have account usage diagnostics.
curl --request GET --max-time 35 \ --url 'https://pokepos-market-api.vercel.app/v1/usage' \ --header "Authorization: Bearer $CARDCOUNTER_API_KEY"{ "account": { "id": "00000000-0000-4000-8000-000000000001", "name": "Example account" }, "plan": "growth", "limits": { "monthlyRequests": 100000, "requestsPerMinute": 120 }, "remaining": { "monthlyRequests": 99872, "requestsThisMinute": 118 }, "periods": { "monthStartsAt": "2026-10-01T00:00:00.000Z", "minuteStartsAt": "2026-10-04T12:30:00.000Z" }}Response object
Get account usage The root schema is Usage.
accountobjectrequiredAccount associated with the API key.
Fields in account
account.idstringrequiredIdentifier for this item or seller.
account.namestringrequiredDisplay name from the source catalog.
planstringrequiredOne of starter, growth, scale.
limitsobjectrequiredMonthly and per-minute account allowances.
Fields in limits
limits.monthlyRequestsintegerrequiredMonthly account request allowance.
limits.requestsPerMinuteintegerrequiredPer-minute account request allowance.
remainingobjectrequiredAllowance remaining in the active periods.
Fields in remaining
remaining.monthlyRequestsintegerrequiredMonthly account request allowance.
remaining.requestsThisMinuteintegerrequiredRequests still available in this UTC minute.
periodsobjectrequiredStart times for the active UTC periods.
Fields in periods
periods.monthStartsAtstringrequiredStart of the active UTC month.
periods.minuteStartsAtstringrequiredStart of the active UTC minute.
Status codes
Get account usage
Check route parameters or the JSON body.
Account-backed key is invalid, inactive, expired or revoked.
Unknown route.
Use the method published for this route.
Quota or admission limit; inspect error.code and Retry-After.
Request failed; preserve x-request-id for support.
The source returned an error. Source 404 may map to API 404.
Account access store is unavailable or misconfigured.
Source request exceeded its budget.
Errors use error.code and error.message. Keep x-request-id for tracing. Read the error code catalog and examples.
Response headers
x-request-idRequest ID for tracing and support.
x-planPlan for admitted account-backed requests.
x-ratelimit-limitAccount allowance per UTC minute.
x-ratelimit-remainingRemaining requests in the UTC minute.
x-monthly-limitAccount allowance per UTC month.
x-monthly-remainingRemaining requests in the UTC month.
Retry-AfterNonnegative seconds until retry is useful for quota, cooldown or admission failures.
Success, empty, partial, stale and error examples
200 · success
{
"account": {
"id": "00000000-0000-4000-8000-000000000001",
"name": "Example account"
},
"plan": "growth",
"limits": {
"monthlyRequests": 100000,
"requestsPerMinute": 120
},
"remaining": {
"monthlyRequests": 99872,
"requestsThisMinute": 118
},
"periods": {
"monthStartsAt": "2026-10-01T00:00:00.000Z",
"minuteStartsAt": "2026-10-04T12:30:00.000Z"
}
}400 · INVALID_INPUT
{
"error": {
"code": "INVALID_INPUT",
"message": "Check route parameters or the JSON body."
}
}401 · INVALID_API_KEY
{
"error": {
"code": "INVALID_API_KEY",
"message": "Account-backed key is invalid, inactive, expired or revoked."
}
}401 · UNAUTHORIZED
{
"error": {
"code": "UNAUTHORIZED",
"message": "The optional local single-key credential is missing or invalid."
}
}404 · NOT_FOUND
{
"error": {
"code": "NOT_FOUND",
"message": "Unknown route."
}
}404 · IMAGE_NOT_AVAILABLE
{
"error": {
"code": "IMAGE_NOT_AVAILABLE",
"message": "No source image is available for this product."
}
}405 · METHOD_NOT_ALLOWED
{
"error": {
"code": "METHOD_NOT_ALLOWED",
"message": "Use the method published for this route."
}
}429 · RATE_LIMITED
{
"error": {
"code": "RATE_LIMITED",
"message": "Minute allowance exhausted; use Retry-After."
}
}429 · MONTHLY_QUOTA_EXCEEDED
{
"error": {
"code": "MONTHLY_QUOTA_EXCEEDED",
"message": "Monthly allowance exhausted; retry after the next UTC month."
}
}429 · AUTH_RATE_LIMITED
{
"error": {
"code": "AUTH_RATE_LIMITED",
"message": "Authentication admission limit reached."
}
}429 · DIAGNOSTIC_RATE_LIMITED
{
"error": {
"code": "DIAGNOSTIC_RATE_LIMITED",
"message": "Usage diagnostic rate limit reached."
}
}500 · INTERNAL_ERROR
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Request failed; preserve x-request-id for support."
}
}502 · UPSTREAM_HTTP_status
{
"error": {
"code": "UPSTREAM_HTTP_503",
"message": "The source returned an error. Source 404 may map to API 404."
}
}502 · UPSTREAM_INVALID_RESPONSE
{
"error": {
"code": "UPSTREAM_INVALID_RESPONSE",
"message": "Source data failed response or identity validation."
}
}502 · UPSTREAM_RESPONSE_TOO_LARGE
{
"error": {
"code": "UPSTREAM_RESPONSE_TOO_LARGE",
"message": "Source or aggregate API response exceeds the byte limit."
}
}502 · UPSTREAM_NETWORK_ERROR
{
"error": {
"code": "UPSTREAM_NETWORK_ERROR",
"message": "Source transport failed."
}
}502 · UPSTREAM_CANCELED
{
"error": {
"code": "UPSTREAM_CANCELED",
"message": "Source work was canceled."
}
}503 · ACCESS_STORE_UNAVAILABLE
{
"error": {
"code": "ACCESS_STORE_UNAVAILABLE",
"message": "Account access store is unavailable or misconfigured."
}
}503 · USAGE_UNAVAILABLE
{
"error": {
"code": "USAGE_UNAVAILABLE",
"message": "Usage diagnostics require account-backed mode."
}
}503 · SERVICE_BUSY
{
"error": {
"code": "SERVICE_BUSY",
"message": "Service admission capacity exhausted; use Retry-After."
}
}503 · ACCESS_BUSY
{
"error": {
"code": "ACCESS_BUSY",
"message": "Database authorization capacity exhausted; use Retry-After."
}
}503 · UPSTREAM_BUSY
{
"error": {
"code": "UPSTREAM_BUSY",
"message": "Source queue is full; use Retry-After."
}
}503 · OCR_BUSY
{
"error": {
"code": "OCR_BUSY",
"message": "Photo recognition queue is full; use Retry-After."
}
}503 · OCR_UNAVAILABLE
{
"error": {
"code": "OCR_UNAVAILABLE",
"message": "Photo recognition is unavailable."
}
}504 · UPSTREAM_TIMEOUT
{
"error": {
"code": "UPSTREAM_TIMEOUT",
"message": "Source request exceeded its budget."
}
}504 · OCR_TIMEOUT
{
"error": {
"code": "OCR_TIMEOUT",
"message": "Photo recognition exceeded its processing budget."
}
}504 · REQUEST_DEADLINE_EXCEEDED
{
"error": {
"code": "REQUEST_DEADLINE_EXCEEDED",
"message": "Total request deadline exceeded."
}
}