Resolve a postal/ZIP code to its place name(s), administrative divisions, and co

Resolve a postal/ZIP code to its place name(s), administrative divisions, and coordinates. Pass `postalCode` and a 2-letter `country` (default US). Returns each matching locality: place, admin1 (state/province name + code), admin2 (county/district), and lat/lon. International — covers major markets (US, GB, CA, DE, FR, AU, NL, ES, IT, CH, SE, MX). Use it to normalize and enrich addresses, derive the state/county for a ZIP, or geolocate a postal code in an ETL pipeline.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://2s.io/api/geo/postal

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "country": "US",
    "postalCode": "90210"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "properties": {
        "method": {
          "const": "GET"
        },
        "queryParams": {
          "properties": {
            "country": {
              "description": "2-letter ISO country code (default US).",
              "type": "string"
            },
            "postalCode": {
              "description": "Postal / ZIP code.",
              "type": "string"
            }
          },
          "required": [
            "postalCode"
          ]
        },
        "type": {
          "const": "http"
        }
      },
      "required": [
        "type",
        "method",
        "queryParams"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON