State & City From Postal Code

POST

/zip-to-state

Get the detailed info of a country code and zip code

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠401Unauthorized Response

🔴500Server Error Response

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api.byelabel.com/v1/zip-to-state?filter={"parent_code":"US"}' \
--header 'X-Workspace-Id: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country_code": "string",
    "zip_code": "string"
}'

Response Example

200 - Example 1

{
    "success": true,
    "payload": {
        "zip_code": "string",
        "country": "string",
        "country_code": "string",
        "state": "string",
        "state_code": "string",
        "city": "string"
    },
    "transaction": {
        "id": "string",
        "response_time": 0
    }
}

Modified at 2026-02-08 01:45:12

State/Province List

Get Carrier Rates