API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

Get Postal Codes for a Country

Get a list of postal codes for the specified country (e.g. for sub-country targeting).

Example - get postal codes for Greece:

GET /backstage/api/1.0/resources/countries/GR/postal
{
   "results": [
      {
         "name": "590 31",
         "value": "590 31, Imathia, Kentriki Makedonia"
      },
      {
         "name": "590 35",
         "value": "590 35, Imathia, Kentriki Makedonia"
      },
      {
         "name": "222 00",
         "value": "222 00, Arkadia, Peloponnisos"
      },
      {
         "name": "118 51",
         "value": "118 51, Attiki"
      }
      // Additional rows (objects) omitted
   ]
}

🚧

Large Payloads

Certain countries (e.g the US) return a large payload for postal codes.

📘

You must provide a valid country code - see: Get list of Countries.)
The country code is not case sensitive.
If you provide an invalid country code, the API returns a JSON object with 404 Not Found.

Language