Mappls Digipin APIs¶

Easy To Integrate Maps & Location APIs & SDKs For Web & Mobile Applications

Powered with India's most comprehensive and robust mapping functionalities.

You can get your api key to be used in this document here: https://about.mappls.com/api/

Introduction¶

India Post’s Digipin initiative introduces a standardized, grid-based digital addressing format for every 4m x 4m (approximately) location across India — covering both built-up and unbuilt areas. While not a unique identifier for specific addressable entities like buildings or shops (unlike property-linked IDs), it serves as a simple, fixed-location reference similar in concept to global systems like Geohash.

MapmyIndia is developing a powerful and easy-to-integrate Digipin Conversion API that enables two-way conversion between Digipins and geographic coordinates (latitude/longitude). This API offers a lightweight, scalable alternative for applications requiring standardized grid references—ideal for digital infrastructure, coverage mapping, verification, and planning use cases.

Designed to complement MapmyIndia’s advanced location-based services, this API can enhance your product’s ability to engage with India's evolving digital address ecosystem. Whether you're building platforms for logistics, utility planning, rural outreach, or governance, this API provides a reliable, uniform location reference layer—backed by the geospatial expertise of MapmyIndia.

Live Demo¶

You can also experience this Digipin Conversion through our Mappls Portal. For experience please click here

Getting Access¶

Before using the API in the your solution, please ensure that the related access is enabled in the Mappls Console, within your app - be it for Mobile OR Web or Cloud integration.

Copy and paste the key from your credentials section from your API keys into the access_token query parameter.
- Your static key can be secured by whitelisting its usage for particular IPs (in case of cloud app usage) OR a set of domains (in case of a web app)
- Your static key obtained from your Console is to be passed as a query parameter: access_token.

Authentication Object - `access_token` mandatory query parameter.¶

access_token: "hklmgbwzrxncdyavtsuojqpiefrbhqplnm".

Input Method¶

GET

Input URL¶

https://sdk.mappls.com/map/api/digipin?

Request Parameters¶

Mandatory Parameters¶

digipin(string): Digipin (with or without hyphens) 10 characters of digipin.

OR

mapplsPin(string): 6 charater Mappls pin for which the user wishes to fetch the Digipin for.

OR

coordinates(string): latitude,longitude - comma separated latitude & longitude pair in decimal degree format (WGS-84 datum) for which you need to determin the Digipin for. The coordinates should be at-least of atleast 5 decimal precision or better for accurate Digipin determination.

Optional Parameters¶

Not Applicable

Response Parameters¶

When input is Digipin¶

latitude(double): the latitude of the Digipin in WPS-84 decimal degree format.
longitude(double): the longitude of the Digipin in WPS-84 decimal degree format.
bounds (array): array of coordinates of the digipin grid following right-hand rule.

When input are Coordinates¶

digipin(string): The The formatted Digipin with hyphens for the provided coordinates.

When input is Mappls pin¶

digipin(string): The formatted Digipin with hyphens for the provided Mappls pin.

Response Type¶

JSON

Response Codes¶

Success:¶

200: To denote a successful API call.
204: To denote the API was a success but no results we’re found.

Client-Side Issues:¶

400: Bad Request, User made an error while creating a valid request.
401: Unauthorized, Developer’s key is not allowed to send a request with restricted parameters.
403: Forbidden, Developer’s key has hit its daily/hourly limit

Server-Side Issues:¶

500: Internal Server Error, the request caused an error in our systems.
503: Service Unavailable, during our maintenance break or server downtime.

Sample Input cURL¶

Input is coordinates¶

curl --location 'https://sdk.mappls.com/map/api/digipin?coordinates="28.62722117136,77.235543104"&access_token=hklmgbwzrxncdyavtsuojqpiefrbhqplnm'

Sample Response¶

{
    "digipin": "39J-4T9-9C9L"
}

Input is Digipin¶

curl --location 'https://sdk.mappls.com/map/api/digipin?digipin=39J-49P-7FTJ&access_token=hklmgbwzrxncdyavtsuojqpiefrbhqplnm'

Sample Response¶

{
    "latitude": 28.627222,
    "longitude": 77.235537,
    "bounds": [
        [
            77.235519,
            28.627239
        ],
        [
            77.235554,
            28.627239
        ],
        [
            77.235554,
            28.627205
        ],
        [
            77.235519,
            28.627205
        ],
        [
            77.235519,
            28.627239
        ]
    ]
}

For any queries and support, please contact:

Email us at apisupport@mappls.com

Support Need support? contact us!