Account and usage API

Account Usage

Retrieve your current plan, monthly request limit, usage count, and remaining requests for the current billing period.

Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.postalkit.mx/v1/account/usage

Response

{
  "data": {
    "plan": "free",
    "monthly_limit": 100,
    "usage_count": 42,
    "remaining": 58,
    "period": "2026-08"
  }
}

Database Version

Retrieve when the postal catalog last changed, when it was last checked against the official source, and the current API version.

Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.postalkit.mx/v1/account/db-version

Response

{
  "data": {
    "last_updated": "2026-08-01T03:00:00.000000Z",
    "catalog_version": "2026-08-01",
    "last_checked_at": "2026-09-01T03:00:00.000000Z",
    "version": "1.0.0"
  }
}

last_checked_at moves on the first of every month whether or not the published catalog changed, so a last_updated that has not moved in months is a source that has not moved. Every recorded run is listed on Catalog updates.