Skip to documentation
DOCUMENTATIONAPI referenceAccountGet account usage
ACCOUNT / V1

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.

GET/v1/usage
Bearer key requiredJSON response

Local anonymous and single-key modes do not have account usage diagnostics.

Example requestv1
curl --request GET --max-time 35 \  --url 'https://pokepos-market-api.vercel.app/v1/usage' \  --header "Authorization: Bearer $CARDCOUNTER_API_KEY"
Response illustrative JSON
{  "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"  }}
Example values can change with the source.
RESPONSE

Response object

Get account usage The root schema is Usage.

accountobjectrequired

Account associated with the API key.

Fields in account
account.idstringrequired

Identifier for this item or seller.

account.namestringrequired

Display name from the source catalog.

planstringrequired

One of starter, growth, scale.

limitsobjectrequired

Monthly and per-minute account allowances.

Fields in limits
limits.monthlyRequestsintegerrequired

Monthly account request allowance.

limits.requestsPerMinuteintegerrequired

Per-minute account request allowance.

remainingobjectrequired

Allowance remaining in the active periods.

Fields in remaining
remaining.monthlyRequestsintegerrequired

Monthly account request allowance.

remaining.requestsThisMinuteintegerrequired

Requests still available in this UTC minute.

periodsobjectrequired

Start times for the active UTC periods.

Fields in periods
periods.monthStartsAtstringrequired

Start of the active UTC month.

periods.minuteStartsAtstringrequired

Start of the active UTC minute.

HTTP

Status codes

200

Get account usage

400

Check route parameters or the JSON body.

401

Account-backed key is invalid, inactive, expired or revoked.

404

Unknown route.

405

Use the method published for this route.

429

Quota or admission limit; inspect error.code and Retry-After.

500

Request failed; preserve x-request-id for support.

502

The source returned an error. Source 404 may map to API 404.

503

Account access store is unavailable or misconfigured.

504

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-id

Request ID for tracing and support.

x-plan

Plan for admitted account-backed requests.

x-ratelimit-limit

Account allowance per UTC minute.

x-ratelimit-remaining

Remaining requests in the UTC minute.

x-monthly-limit

Account allowance per UTC month.

x-monthly-remaining

Remaining requests in the UTC month.

Retry-After

Nonnegative 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."
  }
}