Data API reference

Read-only reference data over HTTPS. Stable schemas, versioned paths, and predictable pagination.

Operational

Authentication

Every request carries a bearer token in the Authorization header. Tokens are scoped per environment and do not expire on a fixed schedule; rotate them from the account console.

curl https://api-us.itsforthevante.ir/data/v2/regions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Unauthenticated requests receive 401 with a JSON body. There is no anonymous tier.

Rate limits

Window	Limit	Header
per minute	600 requests	X-RateLimit-Remaining
per day	250,000 requests	X-RateLimit-Reset
burst	60 requests / 5s	Retry-After

Endpoints

Method	Path	Description
GET	/data/v2/regions	List available regions
GET	/data/v2/regions/{code}	Fetch a single region
GET	/data/v2/currencies	Currency codes and precision
GET	/data/v2/timezones	IANA zones with offsets
POST	/data/v2/lookup	Batch resolve up to 500 keys

Responses

Collections are wrapped in an envelope with a cursor. Pass cursor back verbatim to page forward.

{
  "data": [
    { "code": "us-east", "label": "US East",  "active": true  },
    { "code": "us-west", "label": "US West",  "active": true  },
    { "code": "eu-cent", "label": "EU Central","active": false }
  ],
  "cursor": "eyJvIjoxMjB9",
  "has_more": true
}

Error codes

Status	Code	Meaning
400	invalid_request	Malformed query or body
401	unauthorized	Missing or invalid token
404	not_found	Unknown resource identifier
429	rate_limited	Window exhausted; see Retry-After
503	unavailable	Upstream refresh in progress

Changelog

2026-07-02Added active flag to region objects.
2026-04-18/lookup batch ceiling raised to 500 keys.
2026-01-09Cursor pagination replaces offset paging on all collections.
2025-10-22v2 released; v1 enters maintenance.