# Postfinder Postcodes API

**Canonical:** https://apis.io/apis/postfinder-io/postfinder-io-postcodes-api/  
**Provider:** Postfinder — https://apis.io/providers/postfinder-io/  
**Base URL:** https://api.postfinder.io  
**Documentation:** https://postfinder.io/api/

Postfinder Postcodes API is one of 5 APIs that [Postfinder](https://apis.io/providers/postfinder-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Postcodes. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Postcode lookup, in both directions.

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/countries/{country}/postcodes` | Every postcode in a country, grouped by region |
| GET | `/v1/countries/{country}/postcodes/{postcode}` | Resolve one postcode to the suburbs it covers |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/openapi/postfinder-io-postcodes-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-places-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-nearby-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-search-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-countries-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-category-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/postfinder-io/refs/heads/main/json-schema/postfinder-io-postcodes-response-schema.json

## Other Postfinder APIs (4)

- [Postfinder Nearby API](https://apis.io/apis/postfinder-io/postfinder-io-nearby-api/)
- [Postfinder Places API](https://apis.io/apis/postfinder-io/postfinder-io-places-api/)
- [Postfinder Reference API](https://apis.io/apis/postfinder-io/postfinder-io-reference-api/)
- [Postfinder Search API](https://apis.io/apis/postfinder-io/postfinder-io-search-api/)

## Tags

Postcodes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/postfinder-io/postfinder-io-postcodes-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/postfinder-io/.