Skip to content
Pincode Zone

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.

No API key 60 requests / minute / IP Works across websites

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

Endpoints

GET endpointReturns
/pincodes/{pincode}PIN details, all linked states and districts, and a page of post offices.
/post-offices?q=jorhatPost offices matching a name or PIN prefix.
/post-offices/{id}One active post office, using an ID returned by another endpoint.
/statesStates and union territories with listed post offices.
/states/{state_slug}/districtsDistricts 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, PO or BO. The source dataset uses PO for most sub offices; office_type_label gives the readable label.
  • delivery: delivery or non-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-Limit and X-RateLimit-Remaining show your current quota.
  • 429 means the quota was exceeded. Wait for Retry-After seconds before retrying; avoid repeatedly polling while limited.
  • 404: no such PIN, office, state or endpoint. 405: unsupported method. 422: invalid parameters. Errors include a readable error.message and 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.