API Documentation

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

X-API-Key: YOUR_API_KEY

Get Pincode Details

Retrieve pincode information by pincode value.

Endpoint

GET /api/pincode/{pincode}/

Example Request

curl -X GET "https://apicenter.in/api/pincode/110001/" \
  -H "X-API-Key: YOUR_API_KEY"

[
  {
    "pincode": 110001,
    "country": "INDIA",
    "state": "DELHI",
    "city": "CENTRAL DELHI",
    "district": "CENTRAL DELHI",
    "region": "DELHI",
    "offices": [
      {
        "office_name": "Connaught Place H.O",
        "division": "New Delhi Central Division",
        "office_type": "HO",
        "delivery_status": "Delivery",
        "circle": "Delhi Circle"
      }
    ]
  }
]

Rate Limits

Rate limits are enforced per API key based on your subscription plan:

• Daily limit: Maximum requests per day
• Monthly limit: Maximum requests per calendar month

When limits are exceeded, you'll receive a 429 Too Many Requests response.

Error Responses

{
  "error": "Invalid API key"
}

{
  "error": "Pincode 999999 not found."
}

{
  "error": "Daily limit exceeded",
  "message": "FREE plan daily limit exceeded: 10"
}