API

Geocode

Forward geocode a text address into coordinate candidates. Use when you have an address string and need latitude/longitude. For mixed input types (map links, short codes), prefer Resolve.

POST/v1/geocode

Authorizations

Authorizationstringheaderrequired

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

"Bearer trq_test_…"

Body

{
  "query": "King Fahd Road, Riyadh",
  "country": "SA",
  "language": "en"
}

Response

200 · application/json

Errors

Code	HTTP	When
UNAUTHORIZED	401	Missing or invalid API key or session token.
FORBIDDEN	403	The credential is valid but lacks permission for this action.
INVALID_INPUT	400	The request body failed validation. input and a 2-letter country are required.
COUNTRY_NOT_SUPPORTED	422	Country must be a MENA code such as SA, AE, KW, QA, BH, OM, EG, JO, or MA.
RATE_LIMITED	429	Too many requests for this API key or IP.