- General Information
- Merchants
- Sandbox
- Card Payments
- Hosted Form
- Hosted Fields
- CustomerVault
- Transaction Reporting
- Response Codes
- 3DSecure
- Account Updater
- ACH Payments
- Reporting
- Gateway Test Cards
- Platforms
- Sandbox
- Onboarding
- Reporting
- Residuals
- Tickets
- Connect
- Misc
List Cities and Zip Codes
GET
/api/country/<id>/state/<id>/zip
| Fields | Description | Type | Filterable | Required | Readonly |
|---|---|---|---|---|---|
| id | Unique ID of the zip code | Integer | No | No | Yes |
| zip | Object | Object | No | No | Yes |
| zip.code | Zip code | String | Yes | Yes | Yes |
| zip.type | Standard, Acceptable | ENUM | Yes | No | Yes |
| city | Object | Object | No | No | Yes |
| city.name | Full name of the city | String | Yes | Yes | Yes |
| city.type | Standard, Acceptable | ENUM | Yes | No | Yes |
| county | Full name of the county | String | Yes | No | Yes |
| state | Object | Object | No | No | Yes |
| state.id | The ID of the state | Integer | Yes | No | Yes |
| timezone | Object | Object | No | No | Yes |
| timezone.value | Name of timezone | String | No | No | Yes |
| timezone.utc | Timezone (UTC12) | ENUM | No | No | Yes |
| timezone.dst | Yes, No | ENUM | No | No | Yes |
Request
None
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/country/<id>/state/<id>/zip'Responses
🟢200List Cities and Zip Codes
application/json
Body
Example
{
"items": [
{
"id": "72801",
"zip": {
"code": 90001,
"type": "Standard"
},
"city": {
"name": "Firestone Park",
"type": "Acceptable"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72802",
"zip": {
"code": 90001,
"type": "Standard"
},
"city": {
"name": "Firestone Pk",
"type": "Acceptable"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72803",
"zip": {
"code": 90001,
"type": "Standard"
},
"city": {
"name": "Los Angeles",
"type": "Default"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72804",
"zip": {
"code": 90002,
"type": "Standard"
},
"city": {
"name": "Los Angeles",
"type": "Default"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72805",
"zip": {
"code": 90002,
"type": "Standard"
},
"city": {
"name": "Watts",
"type": "Acceptable"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72806",
"zip": {
"code": 90003,
"type": "Standard"
},
"city": {
"name": "Broadway Manchester",
"type": "NotAcceptable"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72807",
"zip": {
"code": 90003,
"type": "Standard"
},
"city": {
"name": "Los Angeles",
"type": "Default"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72808",
"zip": {
"code": 90004,
"type": "Standard"
},
"city": {
"name": "Los Angeles",
"type": "Default"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72809",
"zip": {
"code": 90004,
"type": "Standard"
},
"city": {
"name": "Oakwood",
"type": "Acceptable"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72810",
"zip": {
"code": 90005,
"type": "Standard"
},
"city": {
"name": "Los Angeles",
"type": "Default"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72811",
"zip": {
"code": 90005,
"type": "standard"
},
"city": {
"name": "Sanford",
"type": "Acceptable"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72812",
"zip": {
"code": 90006,
"type": "standard"
},
"city": {
"name": "Los Angeles",
"type": "Default"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72813",
"zip": {
"code": 90006,
"type": "standard"
},
"city": {
"name": "Pico Heights",
"type": "NotAcceptable"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72814",
"zip": {
"code": 90007,
"type": "standard"
},
"city": {
"name": "Dockweiler",
"type": "Acceptable"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
},
{
"id": "72815",
"zip": {
"code": 90007,
"type": "standard"
},
"city": {
"name": "Los Angeles",
"type": "Default"
},
"county": "Los Angeles",
"state": {
"id": 5
},
"timezone": {
"value": "Pacific",
"utc": "-8.0",
"dst": "Yes"
}
}
],
"_links": {
"self": {
"href": "/api/country/199/state/5/zip?page=1"
}
},
"_meta": {
"totalCount": 4348,
"pageCount": 145,
"currentPage": 1,
"perPage": 30
}
}Modified at 2025-08-09 05:39:41