Status Endpoint

The status endpoint returns information about your current quota.

Requests to this endpoint do not count against your quota or rate limit.

GET/v3/status

Check API Status

This status endpoint returns information about your current quota.

Response Properties

Name
account_id
Type
integer
Description
Your account id.
Name
quotas
Type
object
Description
Contains information about your request quota, split into a month bucket (your regular plan quota) and a grace bucket (a temporary buffer granted when a subscription payment fails — while it is active, requests count against it instead of the month bucket; for accounts in good standing it is all zeroes).
Name
quotas.month.total
Type
integer
Description
Your total monthly request quota.
Name
quotas.month.used
Type
integer
Description
Requests used in the current month.
Name
quotas.month.remaining
Type
integer
Description
Requests remaining in the current month.
Name
quotas.grace
Type
object
Description
The grace quota bucket with the same total / used / remaining fields.

Request

GET

/v3/status

curl -G https://api.currencyapi.com/v3/status \
    -H "apikey: YOUR-API-KEY"

Response

{
  "account_id": 313373133731337,
  "quotas": {
    "month": {
      "total": 300,
      "used": 72,
      "remaining": 228
    },
    "grace": {
      "total": 0,
      "used": 0,
      "remaining": 0
    }
  }
}