DIGIPIN

Overview

The DIGIPIN API helps verify the authenticity of geolocation points through a proprietary digital pin format. It takes either DIGIPINs or raw lat/long values, returning validated location data and the straight-line displacement between them.

API Description

API cURL

curl --location 'https://api.signzy.app/api/v3/digipin' \
--header 'Content-Type: application/json' \
--header 'Authorization:(Auth Token)' \
--data-raw '{
    "digipin1": "F32-456-789T",
    "digipin2": "",
    "latitude1": "",
    "longitude1": "",
    "latitude2": "19.0760",
    "longitude2": "72.8777"
}'

Note: Exactly one of these combinations must be provided:

Two DIGIPIN codes (digipin1 and digipin2)

Two coordinate pairs (latitude1, longitude1, latitude2, longitude2)

One DIGIPIN and one coordinate pair (digipin1 with latitude2, longitude2 OR latitude1, longitude1 with digipin2)

Input Table

Parameter	Required	Type	Description
digipin1	Conditional	String	First DIGIPIN (10 alphanumeric characters, optional hyphens)
digipin2	Conditional	String	Second DIGIPIN (optional)
latitude1	Conditional	Number	First latitude coordinate (2.5° to 38.5°)
longitude1	Conditional	Number	First longitude coordinate (63.5° to 99.5°)
latitude2	Conditional	Number	Second latitude coordinate (optional, same range as above)
longitude2	Conditional	Number	Second longitude coordinate (optional, same range as above)

API Output

{
  "point1": {
    "digipin": "string",
    "latitude": "number",
    "longitude": "number"
  },
  "point2": {
    "digipin": "string", 
    "latitude": "number",
    "longitude": "number"
  },
  "distanceKm": "number"
}

Output Table

Parameter	Type	Description	Example
point1.digipin	String	DIGIPIN for first point (converted if input was coordinates)	"F32-456-789T"
point1.latitude	Number	Latitude for first point (converted if input was DIGIPIN)	28.613947
point1.longitude	Number	Longitude for first point (converted if input was DIGIPIN)	77.209024
point2.digipin	String	DIGIPIN for second point (converted if input was coordinates)	"J45-678-9CL"
point2.latitude	Number	Latitude for second point (converted if input was DIGIPIN)	19.076090
point2.longitude	Number	Longitude for second point (converted if input was DIGIPIN)	72.877656
distanceKm	String	Distance between two points in kilometers	1144.32

Status Code:

Code	status	Description
200	Success	The request id was successfully generated.
400	Bad Request	Invalid input data
409	Upstream Error	Error in fetching data from upstream.
500	Internal Server Error	Something is broken. This is usually a temporary error, for example in a high-load situation.or if an endpoint is temporarily having issues. Try again later.