Authentication & Headers
Send every API call using POST or GET. Include your API key in the request header.
How to Send a POST Request
- Open Postman and select
POST. - Copy the service endpoint URL shown below.
- In Headers, add
Content-Type: application/jsonandX-API-KEY: your_api_key. - Open Body → raw → JSON, paste the JSON request body, then click Send.
curl -X POST "http://localhost/api_project/gateway.php?service=RC_MANUAL_2" \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY_HERE" \
-d '{"engine_number":"ENG123456789"}'
Quick API Test — No JSON Needed
Choose a service, enter the required number, and send the request directly.
1. Rice Card Verification (`RICE_CARD`)
Retrieve Rice Card details, FPS shop ID, and household member information.
http://localhost/api_project/gateway.php?service=RICE_CARD
{
"rice_card_number": "2804384271"
}
2. PAN Search by Aadhaar (`PAN_SEARCH`)
Search PAN information using an Aadhaar number.
http://localhost/api_project/gateway.php?service=PAN_SEARCH
{
"aadhaar_number": "123456789012",
"consent": true
}
3. PAN Find by Aadhaar (`PAN_FIND`)
Retrieve the full PAN number and PAN status linked to an Aadhaar card.
http://localhost/api_project/gateway.php?service=PAN_FIND
{
"aadhaar_number": "123456789012",
"consent": true
}
PAN Details Verification (PAN_DETAILS)
Retrieve verified PAN holder details after receiving customer consent.
http://localhost/api_project/gateway.php?service=PAN_DETAILS
{
"pan_number": "ABCDE1234F",
"consent": true
}4. Driving Licence PDF Download (`DL_PDF`)
Retrieve a Base64 PDF and local file download using a licence number and date of birth.
http://localhost/api_project/gateway.php?service=DL_PDF
{
"dl_number": "AP12345678901234",
"dob": "01-01-2000",
"consent": true
}
5. RC Manual by Vehicle No (`RC_MANUAL_1`)
Create a manual RC request using a vehicle number. It is charged immediately and returns a `request_id`.
http://localhost/api_project/gateway.php?service=RC_MANUAL_1
{
"vehicle_number": "TS09AB1234"
}
6. RC Manual by Engine/Chassis (`RC_MANUAL_2`)
Send either an engine number or a chassis number.
http://localhost/api_project/gateway.php?service=RC_MANUAL_2
{
"engine_number": "ENG123456789"
}
{
"chassis_number": "MA3EWB22S00ABCDE1"
}
7. RC Manual Status Check (`RC_MANUAL_STATUS`)
Use the returned `request_id` to check the current status and retrieve the Base64/PDF file when complete.
http://localhost/api_project/gateway.php?service=RC_MANUAL_STATUS&request_id=REQ_123456
{
"status": true,
"code": 200,
"data": {
"request_id": "REQ_123456",
"status": "COMPLETED",
"type": "binary",
"mime": "application/pdf",
"file_url": "storage/pdfs/doc_1_1725000000.pdf",
"file_base64": "JVBERi0xLjQKJcTl8uXr..."
}
}