This document was designed for IT professionals as a technical document to communicate and understand the Postal Code API
This service allows autocomplete on the suburb
https://nservice.aramex.co.za/Json/JsonV1/GetPostalCodes
| Field Name | Description | Mandatory | Field Length | Data Type |
|---|---|---|---|---|
| email_address | Aramex.com email address used for authentication | Yes | 300 | string |
| account_number | Your Aramex account number | Yes | 100 | string |
| country_code | Can search by country code | Yes | 10 | string |
| suburb | The suburb for the country | Yes | 50 | string |
| postal_code | The postal code for the country. This service does not support postal codes which contain prefixes and suffexes. | No | 20 | string |
| Field Name | Description | Field Length | Data Type |
|---|---|---|---|
| status_code | The status code for the transaction submitted. The status code will state if the transaction was successful or if it failed | 3 | int |
| status_description | The description associated with the status code | 255 | string |
| postalCodes | The list of all the postal codes | N/A | List |
| Field Name | Description | Field Length | Data Type |
|---|---|---|---|
| country_code | Country code | 10 | string |
| country_zone | Country Zone | 10 | string |
| service_entity | The service entity for the suburb | 20 | string |
| entity | The entity that services the suburb | 20 | string |
| suburb_name | The suburb name | 50 | string |
| city | The city name | 50 | string |
| state_name | The Province or city | 50 | string |
| postal_prefix | The prefix if the country has prefixes | 10 | string |
| postal_code | The postal code if the country has postal codes | 10 | string |
| postal_suffix | This is included in the json response but will return empty string | 10 | string |
| location_code | This is the location code for the suburb | 10 | string |
| route_code | Route Code | 10 | string |
| route_name | Route Name | 10 | string |
| mon | if the suburb is serviced on a Monday | 5 | boolean |
| tue | if the suburb is serviced on a Tuesday | 5 | boolean |
| wed | if the suburb is serviced on a Wednesday | 5 | boolean |
| thu | if the suburb is serviced on a Thursday | 5 | boolean |
| fri | if the suburb is serviced on a Friday | 5 | boolean |
| sat | if the suburb is serviced on a Saturday | 5 | boolean |
| sun | if the suburb is serviced on a Sunday | 5 | boolean |
| is_regional | Is Regional | 5 | boolean |
| is_outlying | Is Outlying | 5 | boolean |