Pincode Distance Calculator API

Overview

The Pincode Distance API calculates the approximate distance in kilometers between two Indian PIN codes. By providing a source PIN code and a destination PIN code, the API returns the distance between the two locations.

This API is useful for logistics, delivery planning, serviceability checks, risk assessment, and determining the geographical proximity between two locations. The calculated distance can be used to optimize operations and support location-based decision making.

Use Cases

Calculate the distance between two Indian PIN codes.

Estimate delivery or shipping distances.

Validate customer proximity for serviceability.

Support logistics planning and route optimization.

Enhance fraud detection and risk assessment based on geographic distance.

Endpoint

POST /api/v3/pintopindist

Headers

Header	Required	Description
Authorization	Yes	Bearer token/API authorization token
Content-Type	Yes	application/json

Request Body

Field	Type	Required	Description
sourcePincode	String	Yes	6-digit source Indian PIN code.
destinationPincode	String	Yes	6-digit destination Indian PIN code.

Sample Request

{ "sourcePincode": "452016", "destinationPincode": "452020" }

Response

Field	Type	Description
result	Object	API result object
result.sourcePincode	String	Source PIN code provided in the request
result.destinationPincode	String	Destination PIN code provided in the request
result.distanceInKm	Integer	Approximate distance between the two PIN codes in kilometers
result.message	String	Status message indicating the result of the calculation
reason	String	API response message
code	String	API response code

Sample Response

{ "result": { "sourcePincode": "452016", "destinationPincode": "452020", "distanceInKm": 35, "message": "Distance calculated successfully" }, "reason": "Request Successful", "code": "S001" }

Response Codes

Code	Description
S001	Request Successful

Notes

This API is supported only for Indian PIN codes.

Both sourcePincode and destinationPincode are mandatory.

The returned distance is an approximate straight-line/geographical distance between the two PIN codes and should not be interpreted as actual travel distance.

The distance is returned in kilometers (km).