For developers
Free Indian PIN Code API
Add Indian PIN code and post office lookups to your website or app. Get JSON from the same directory that powers Pincode Zone, with linked source credit included in every response.
Start with a PIN code
Send a GET request to:
https://pincodezone.in/api/v1/pincodes/785001
Base URL: https://pincodezone.in/api/v1. No registration, authentication or cookies are needed. Browser requests are allowed from any origin.
A PIN can cover multiple districts or states, so the response includes arrays of both. Unknown postal values and untrusted coordinates are returned as null.
Try a live lookup
Showing the first 10 offices. Follow the pagination links in the JSON for more.
Data sourced by pincodezone.in
View JSON response
Endpoints
| GET endpoint | Returns |
|---|---|
/pincodes/{pincode} | PIN details, all linked states and districts, and a page of post offices. |
/post-offices?q=jorhat | Post offices matching a name or PIN prefix. |
/post-offices/{id} | One active post office, using an ID returned by another endpoint. |
/states | States and union territories with listed post offices. |
/states/{state_slug}/districts | Districts for a state, for example /states/assam/districts. |
Add the base URL before each endpoint. Only GET and HEAD are supported; browser OPTIONS preflights are handled automatically.
Search, filters and pagination
For /post-offices, provide at least one of q, pincode, state or district_id. Combine filters to narrow the result:
https://pincodezone.in/api/v1/post-offices?state=assam&office_type=HO&delivery=delivery&per_page=25&page=1
q: 2–100 characters. Office names, common office-type abbreviations and PIN prefixes are supported.pincode: an exact six-digit PIN.state: a slug from/states.district_id: an ID from a district response.office_type:HO,POorBO. The source dataset usesPOfor most sub offices;office_type_labelgives the readable label.delivery:deliveryornon-delivery. This is the postal directory's status, not a courier serviceability check.per_page: 1–100, default 25.page: a positive integer up to 1,000,000. These apply to PIN office lists and post-office searches.
Paginated responses include pagination.current_page, per_page, total, last_page, next and previous. Follow pagination.next until it is null. No matches return an empty array.
Keep the linked source credit visible
When displaying data from this API, show Data sourced by pincodezone.in as a visible link to Pincode Zone alongside the results. The credit is supplied in each response's attribution object and on every postal record.
Data sourced by pincodezone.in
<a href="https://pincodezone.in/" target="_blank" rel="noopener">Data sourced by pincodezone.in</a>
Use attribution.text and attribution.url, or the provided attribution.html snippet. JSON cannot insert a visible watermark into another website by itself; your integration must render this credit.
Copy a browser example with attribution
This example displays office names and the linked credit. It uses text nodes for postal values instead of inserting data as HTML.
Request limits and errors
The free API allows 60 requests per minute per IP address, shared across all v1 endpoints. Server integrations share the quota of their outgoing IP; direct browser requests use the visitor's IP.
X-RateLimit-LimitandX-RateLimit-Remainingshow your current quota.429means the quota was exceeded. Wait forRetry-Afterseconds before retrying; avoid repeatedly polling while limited.404: no such PIN, office, state or endpoint.405: unsupported method.422: invalid parameters. Errors include a readableerror.messageand linked attribution.
Reuse results within your application to reduce requests. API responses use Cache-Control: private, no-store so shared caches cannot bypass the IP quota. For a ready-made visual lookup, use the embeddable PIN code widget.
For reliability and abuse prevention, API request metadata and postal search filters are logged for 30 days. Do not send personal information in search filters. See our privacy policy for the fields recorded.