Developer API Reference

v1.0 (2026-09)

High-performance, machine-readable REST API delivering structured Indian postal, administrative, and DIGIPIN addressing data. Zero API keys required for standard lookups.

OpenAPI 3.0 Spec → MCP Server Manifest →
Base URI
https://pincodez.info/api/v1
HTTPS Required
Payload Format
JSON
application/json • UTF-8
Authentication
None Required
Public open core
CORS Policy
Enabled
Access-Control-Allow-Origin: *
FIG 5.0 • APPLICATION INTEGRATION & AGENT PROTOCOL ARCHITECTURE REST API v1 • MCP SPECIFICATION • FTS5 ENGINE
Pincodez Developer API and Agent Protocol Architecture

Core API Endpoints

GET /api/v1/pincodes/{pincode}
Postal Zone Lookup

Returns complete postal specifications, administrative hierarchy, centroid coordinates, DIGIPIN, and all post offices serving the specified 6-digit PIN code.

cURL Request Example 
curl -s "https://pincodez.info/api/v1/pincodes/122001"
Response Payload (200 OK) 
{
  "pincode": "122001",
  "state": { "name": "Haryana", "type": "State", "state_code": "06" },
  "district": { "name": "Gurugram", "district_code": "068" },
  "circle_name": "Haryana",
  "total_post_offices": 12,
  "centroid": {
    "latitude": 28.4595,
    "longitude": 77.0266,
    "digipin": "2847TB99M4"
  }
}
POST /api/v1/validate
Address Consistency Engine

Cross-references submitted address attributes against India Post and LGD registries, computing an Address Quality Score (0–100) and returning explicit verification evidence.

cURL POST Request 
curl -s -X POST "https://pincodez.info/api/v1/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "pincode": "122001",
    "state": "Haryana",
    "district": "Gurugram"
  }'
Response Payload (200 OK) 
{
  "valid": true,
  "status": "VALID",
  "quality_score": 100,
  "conflicts": [],
  "warnings": [],
  "checks": [
    { "name": "PIN Code Exists", "status": "PASS", "description": "PIN 122001 is active in official registry" },
    { "name": "State Consistency", "status": "PASS", "description": "State Haryana matches PIN circle" }
  ]
}
POST /api/v1/resolve
Natural Language Entity Resolution

Parses unstructured Indian address text into a structured location entity with coordinates and DIGIPIN code.

cURL POST Request 
curl -s -X POST "https://pincodez.info/api/v1/resolve" \
  -H "Content-Type: application/json" \
  -d '{ "address": "Cyber City, DLF Phase 2, Gurugram, Haryana 122002" }'
GET /api/v1/search?q={query}&limit={n}
FTS5 Full-Text Search

Queries PIN codes, post offices, districts, and states with sub-millisecond SQLite FTS5 response times.

cURL Request Example 
curl -s "https://pincodez.info/api/v1/search?q=Connaught+Place&limit=5"
GET /api/v1/digipin/encode?lat={lat}&lon={lon}
Spatial Grid Encoding

Converts geographic coordinates into the official 10-character India Post DIGIPIN grid representation.

cURL Request Example 
curl -s "https://pincodez.info/api/v1/digipin/encode?lat=28.622788&lon=77.213033"
Integration Code Snippets Native implementations

JavaScript (Fetch)

const res = await fetch('https://pincodez.info/api/v1/pincodes/110001');
const { data } = await res.json();
console.log(data.district.name, data.centroid.digipin);

Python (Requests)

import requests

res = requests.get('https://pincodez.info/api/v1/pincodes/110001')
data = res.json()
print(data['district']['name'])
Attribution Requirement: Data sourced from India Post & MoPR LGD via Pincodez.info under GODL.
Source Provenance Register →