geo

Resolve a postal/ZIP code to its place name(s)...

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.

get/api/geo/postal

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/geo/postal
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

postalCodestring required

Postal code.

countrystring

Country name or ISO country code.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.