What it returns
Every current UK postcode, from Office for National Statistics and Ordnance Survey open data.
Postcode, latitude/longitude, eastings/northings, country, region, district, county, ward, parish, parliamentary constituency, NHS and police areas, LSOA/MSOA, deprivation index and ONS codes. Invalid and terminated postcodes are flagged and not charged.
Common uses
Address forms, delivery zones, store locators, CRM cleaning, property and demographic analysis. Pay per postcode.
Request
POST https://api.pushbuild.com/uk-postcodes/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
postcodes | list of strings | Full UK postcodes, any spacing or case. |
coordinates | list of strings | "lat,lon" points; returns nearest postcodes. |
autocomplete | list of strings | Partial postcodes, e.g. SW1A 1. |
outcodes | list of strings | Postcode districts, e.g. SW1A, M1. |
radiusMeters | integer | Search radius for coordinates (max 2000). Default: 1000. |
maxResultsPerPoint | integer | Postcodes per coordinate or autocomplete (max 100). Default: 10. |
autocompleteDetails | boolean | Return full records instead of postcode strings. Default: true. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/uk-postcodes/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"postcodes": ["SW1A 1AA", "M1 1AE"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 postcodes. No charge for errors or empty searches.
Related APIs
Academic Papers Search API
Search scholarly papers across Crossref (150M+ works), arXiv and PubMed in one run.
Article & Web Page to Markdown API
Turn any URLs into clean, Markdown, text or JSON.
Book Search API
Search millions of books by keyword, title, author, subject or ISBN, plus author lookup.
College Scorecard: US Colleges, Costs, Earnings by Major API
Every US college from the Department of Education College Scorecard: admission rate, SAT/ACT, tuition, net price, completion and retention, median debt and graduates' earnings, plus program-level (major) debt and earnings 1 to 5 years after graduation..
Currency Exchange Rates API
Official European Central Bank reference exchange rates for 30+ currencies, daily since 1999.
CVE Vulnerability Lookup: NVD, CISA KEV, EPSS, OSV API
Look up CVEs by ID or keyword, or check open-source packages for known vulnerabilities.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com