Merchant Management
Get Zipcodes
GET/zipcodes

Returns up to 20 ZIP codes starting with the given 3–5 digits, with city and state.

Header Parameters

token*
string

Query Parameters

zipcode*
string
GET/zipcodes
1curl --location 'https://api.ipospays.tech/invoice-service/v1/zipcodes?zipcode=303' \
2--header 'token: '
Response

// Awaiting response…

Sample response
{
  "data": [
    {
      "zip_code": "30301",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30302",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30303",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30304",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30305",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30306",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30307",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30308",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30309",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30310",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30311",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30312",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30313",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30314",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30315",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30316",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30317",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30318",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30319",
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "zip_code": "30320",
      "city": "Atlanta",
      "state": "GA"
    }
  ],
  "message": "Zipcodes retrieved successfully",
  "response_code": "SUCCESS",
  "status_code": 200,
  "request_id": "TEST-20261008184031-SDKA7N",
  "timestamp": "2026-10-08T13:10:31.143Z"
}