Vehicle → Phone API

Look up the registered phone number for any Indian vehicle number.

Authentication

Every request requires a key. Append ?key=YOUR_KEY. Each vehicle lookup consumes one search from your key's limit.

Endpoints

Health

GET/health 
{"status":"ok","cache":"RedisCache","cache_ok":true,"chassis_api":"...","workers":16}

Single lookup

GET/info?key=K&vehicle=AP05CU6210 
{"reg_no":"AP05CU6210","mobile":"9848072537","time_ms":18234}

On miss: {"status":"Not Found"} with HTTP 404.

Bulk submit — GET (short lists)

GET/info/bulk?key=K&vehicles=A,B,C

Bulk submit — POST (long lists)

POST/info/bulk 
{"key":"K","vehicles":["AP05CU6210","MH12AB1234"]}

Returns {"job_id":"...","total":N} with HTTP 202. The job runs in the background.

Job status

GET/info/bulk/<job_id>?key=K 
{"job_id":"...","status":"running","total":100,"done":42,"hits":7,"started_at":...,"finished_at":null}

Job results — JSON

GET/info/bulk/<job_id>/results/json?key=K 
{"job_id":"...","status":"completed","total":100,"hits":7,
 "results":[{"reg_no":"AP05CU6210","mobile":"9848072537"}]}

Job results — TXT download

GET/info/bulk/<job_id>/results/txt?key=K 
AP05CU62109848072537
MH12AB12349123456780

One vehicle per line, registration and phone separated by a tab. Downloads as vahan_<job>.txt.

Job live view — UI

GET/info/bulk/<job_id>/view?key=K

Auto-refreshing page showing hits as they land. Includes a download button for the TXT file.

Errors

CodeMeaning
400Missing or malformed parameter
401No key supplied
403Key revoked, invalid, or limit exhausted
404Vehicle not found, or job id unknown
429Too many login attempts (admin only)

Quick start

curl "https://your-host/info?key=YOUR_KEY&vehicle=AP05CU6210"

curl -X POST "https://your-host/info/bulk" \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_KEY","vehicles":["AP05CU6210","MH12AB1234"]}'

curl "https://your-host/info/bulk/<job_id>?key=YOUR_KEY"

curl -O "https://your-host/info/bulk/<job_id>/results/txt?key=YOUR_KEY"