Skip to main content
POST
Shortcode Lookup
Resolve a Saudi National Address shortcode (e.g. RBAA2112) into its full address and geographic coordinates.

National Address Shortcodes

National Address shortcodes are compact 8-character identifiers (4 letters + 4 digits) that uniquely identify any property in the Kingdom of Saudi Arabia.

Benefits

  • Efficiency: Faster data entry for your customers.
  • Precision: Direct resolution to a single point.
  • Bilingual: Get the full address in both Arabic and English.

Authorizations

Authorization
string
header
required

JWT Bearer token for authentication. Example: "Bearer YOUR_API_TOKEN_HERE"

Body

application/json

Shortcode to resolve (4 letters + 4 digits)

Shortcode to resolve (4 letters + 4 digits)

shortcode
string

The shortcode to look up (4 letters followed by 4 digits, e.g. ABCD1234)

Example:

"RBAA2112"

Response

OK

data
object

Response payload

error
string

Error message (only present when ok is false)

Example:

""

ok
boolean

Whether the request was successful

Example:

true