API

Validate

Check whether a regional address identifier is syntactically valid without performing a full resolve. Useful for form validation before submission.

POST/v1/validate

Authorizations

Authorizationstringheaderrequired

Bearer token. Use a test key from the dashboard. The header is Authorization: Bearer <token>.

"Bearer trq_test_…"

Body

{
  "input": "RRRR1111",
  "country": "SA"
}

Response

200 · application/json

Errors

CodeHTTPWhen
UNAUTHORIZED401Missing or invalid API key or session token.
FORBIDDEN403The credential is valid but lacks permission for this action.
INVALID_INPUT400The request body failed validation. input and a 2-letter country are required.
COUNTRY_NOT_SUPPORTED422Country must be a MENA code such as SA, AE, KW, QA, BH, OM, EG, JO, or MA.
RATE_LIMITED429Too many requests for this API key or IP.