| Requires any of the roles: | Reseller, Merchant |
| GET | /lookup/postalcodes/{PostalCode} | Gets details for a given postal code |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| PostalCode | query | string | Yes | The postal code to retrieve |
| Country | query | string | No | Optional: Country to search for specified postal code. If not provided, the US will be used |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| PostalCode | form | string | No | |
| CountryCode | form | string | No | |
| Latitude | form | string | No | |
| Longitude | form | string | No | |
| City | form | string | No | |
| State | form | string | No | |
| CityEn | form | string | No | |
| StateEn | form | string | No | |
| StateCode | form | string | No | |
| Province | form | string | No | |
| ProvinceCode | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /lookup/postalcodes/{PostalCode} HTTP/1.1
Host: syntch.simpay.net
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
PostalCode: String,
CountryCode: String,
Latitude: String,
Longitude: String,
City: String,
State: String,
CityEn: String,
StateEn: String,
StateCode: String,
Province: String,
ProvinceCode: String
}