GET /v1/pincodes/{pincode}
PIN Code LookupRetrieve state, district, and post offices for a given 6-digit pincode.
| Parameter | Type | Required | Description |
|---|---|---|---|
| pincode | Path (string) | Yes | 6-digit Indian Pincode (e.g., 600001). |
FastGST India PIN Code Lookup API
A production-grade, high-performance REST API for Indian pincodes providing direct lookups, administrative metadata querying, autocomplete search, and spatial queries. Activate in ConsoleDesk and get your API Key.
Website: https://www.fastgst.in
Get API Key and Manage Access: https://consoledesk.in
Plans & Pricing: https://www.fastgst.in/pricing/
Base URL
https://api.pin.fastgst.in
Authentication: All endpoints need authentication. Get your API Key from ConsoleDesk first. Pass your access key in the X-API-Key HTTP header.
Note: Before using the API, activate it in ConsoleDesk, generate an API Key, and start querying Indian post offices, pincodes, and distances.
PIN Search & Autocomplete
Endpoints for direct pincode lookups and autocomplete matching.
GET /v1/search
Search / AutocompleteSearch for districts and offices matching a case-insensitive query substring.
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | Query (string) | Yes | Query string (at least 3 characters). |
| limit | Query (integer) | No | Max results cap (1-100, default is 20). |
Metadata Search
Administrative hierarchy endpoints listing states, districts, and mapping them to pincodes.
GET /v1/states
State ListRetrieve a unique list of all states in India, sorted alphabetically.
No parameters required.
GET /v1/states/{state}/districts
Districts by StateRetrieve a list of unique districts in a given state (case-insensitive).
| Parameter | Type | Required | Description |
|---|---|---|---|
| state | Path (string) | Yes | State name (case-insensitive). |
GET /v1/districts/{district}/pincodes
PIN Codes by DistrictRetrieve a list of unique pincodes in a given district (case-insensitive).
| Parameter | Type | Required | Description |
|---|---|---|---|
| district | Path (string) | Yes | District name (case-insensitive). |
Location Search & Spatial Math
Coordinates-based geocoding, radius searches, and distance calculation between points.
GET /v1/reverse
Reverse LookupFind the nearest post office and its pincode from latitude and longitude coordinates.
| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | Query (number) | Yes | Latitude (float64 format). |
| lng | Query (number) | Yes | Longitude (float64 format). |
GET /v1/nearby
Nearby OfficesRetrieve post offices located within a specified radius (in km) from coordinates.
| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | Query (number) | Yes | Latitude (float64 format). |
| lng | Query (number) | Yes | Longitude (float64 format). |
| radius | Query (number) | Yes | Search radius in kilometers (float64 format). |
| limit | Query (integer) | No | Max results cap (1-100, default is 20). |
GET /v1/pincodes/{pincode}/nearby
Nearby PIN CodesFind pincodes located within a specified radius (in km) from a given pincode centroid.
| Parameter | Type | Required | Description |
|---|---|---|---|
| pincode | Path (string) | Yes | Origin 6-digit Pincode. |
| radius | Query (number) | Yes | Search radius in kilometers (float64 format). |
GET /v1/distance
Distance Between PINsCalculate the distance (in km) between the centroids of two pincodes.
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | Query (string) | Yes | Origin 6-digit Pincode. |
| to | Query (string) | Yes | Destination 6-digit Pincode. |