Reference

Changelog

Breaking changes will always arrive as a new version prefix. Everything below is additive within /api/v1.

v1.0 — initial release

12 August 2026

Address autocomplete — ranked type-ahead with locality/city split matching.
Address search — filter by PIN code, locality, city, district and state.
Address validation — additive confidence scoring with a corrected canonical address and plain-language issue list.
Pincode lookup — state, district, city, postal hierarchy, localities and post offices.
Geocoding — forward geocoding with rooftop / approximate / centroid precision levels.
Reverse geocoding — nearest known addresses with a haversine distance.
Key status — check plan limits and remaining monthly quota without spending a data call.
Rate limiting — per-minute, per-day and per-month windows with Retry-After and X-RateLimit-* headers.
Request IDs — X-Request-Id on every response, traceable to a single row in your API log.

Bulk import from .xlsx, .xls and .csv with a preview step, duplicate strategy and downloadable error report.
Bulk export to .xlsx and .csv as background jobs, filtered by region, status, source or date.
Address and PIN code management with server-side pagination, sorting and bulk actions.
API key management, usage analytics, searchable request logs and a live playground.

New optional parameters and new response fields can appear in v1 at any time — parse defensively and ignore fields you do not recognise.
Existing fields will not be removed or change type within a version.
Anything breaking ships as /api/v2, and v1 stays available with advance notice before retirement.