RC e-Challan Details
vehiclePending traffic e-Challan details for a vehicle registration (RC) number, sourced from VAHAN/Parivahan. Returns the list of challans and a total count; a vehicle with no pending challans returns echallan_count 0.
POST /gw/v1/rc-challan/SLA p95: 2000 ms
Authentication
Pass your key in the X-API-Key header. Use a test_ key against the sandbox and a live_ key in production. Send an optional Idempotency-Key header to safely retry — the same key returns the same response for 24h.
X-API-Key: live_xxxxxxxxxxxx
Request
Endpoint: POST https://apisathi.in/gw/v1/rc-challan
| Field | Type | Required | Constraints |
|---|---|---|---|
| rc_number | string | required | pattern: ^[A-Z]{2}[0-9]{1,2}[A-Z]{0,3}[0-9]{1,4}$ · Vehicle registration number, e.g. MH14GH2255 |
Code snippets
curl -X POST https://apisathi.in/gw/v1/rc-challan/ \
-H "X-API-Key: $API_SATHI_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"rc_number":"MH14GH2255"}'Response
| Field | Type | Required | Constraints |
|---|---|---|---|
| rc_number | string | optional | — |
| echallan_count | integer | optional | Number of pending challans (0 if the vehicle is clean). |
| challans | object[] | optional | One entry per pending challan. |
Sample response
{
"rc_number": "MH14GH2255",
"echallan_count": 1,
"challans": [
{
"challan_no": "MH00123456789012",
"challan_date": "2026-03-14 10:22:00",
"amount": "500",
"challan_status": "Pending",
"offence": "Over Speeding",
"state": "Maharashtra"
}
]
}Error codes
| Code | HTTP | When |
|---|---|---|
| INVALID_INPUT | 422 | Request body failed schema validation. |
| INVALID_API_KEY | 401 | Missing, malformed, or revoked X-API-Key. |
| OUT_OF_SCOPE | 403 | API key is not scoped for this product. |
| INSUFFICIENT_BALANCE | 402 | Wallet balance is below the per-call sale price. |
| RATE_LIMITED | 429 | Per-key RPS or RPM limit exceeded. See Retry-After. |
| ROUTER_NO_VENDOR | 503 | No healthy vendor is currently available for this product. |
| VENDOR_AUTH_FAILED | 502 | Upstream vendor rejected our credentials. |
| VENDOR_ERROR | 502 | Upstream vendor returned an unexpected error. |
| TIMEOUT | 504 | Upstream vendor did not respond within the SLA window. |
OpenAPI 3.1
Generated from this product's request/response JSON Schemas.
{
"openapi": "3.1.0",
"info": {
"title": "API Sathi — RC e-Challan Details",
"version": "1.0.0",
"description": "Pending traffic e-Challan details for a vehicle registration (RC) number, sourced from VAHAN/Parivahan. Returns the list of challans and a total count; a vehicle with no pending challans returns echallan_count 0."
},
"servers": [
{
"url": "https://apisathi.in/gw/v1"
}
],
"components": {
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"in": "header",
"name": "X-API-Key",
"description": "Your live or test key, e.g. `live_xxxxxxxxxxxx`."
}
}
},
"paths": {
"/rc-challan": {
"post": {
"operationId": "rcChallan",
"tags": [
"vehicle"
],
"summary": "RC e-Challan Details",
"description": "Pending traffic e-Challan details for a vehicle registration (RC) number, sourced from VAHAN/Parivahan. Returns the list of challans and a total count; a vehicle with no pending challans returns echallan_count 0.",
"security": [
{
"ApiKeyAuth": []
}
],
"parameters": [
{
"name": "Idempotency-Key",
"in": "header",
"required": false,
"schema": {
"type": "string"
},
"description": "Optional. Same key returns the same response for 24h."
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"rc_number"
],
"properties": {
"rc_number": {
"type": "string",
"description": "Vehicle registration number, e.g. MH14GH2255",
"pattern": "^[A-Z]{2}[0-9]{1,2}[A-Z]{0,3}[0-9]{1,4}$"
}
},
"additionalProperties": false
},
"example": {
"rc_number": "MH14GH2255"
}
}
}
},
"responses": {
"200": {
"description": "Successful, normalized response.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"rc_number": {
"type": "string"
},
"echallan_count": {
"type": "integer",
"description": "Number of pending challans (0 if the vehicle is clean)."
},
"challans": {
"type": "array",
"description": "One entry per pending challan.",
"items": {
"type": "object",
"properties": {
"challan_no": {
"type": "string"
},
"challan_date": {
"type": "string"
},
"amount": {
"type": "string"
},
"challan_status": {
"type": "string"
},
"offence": {
"type": "string"
},
"state": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"example": {
"rc_number": "MH14GH2255",
"echallan_count": 1,
"challans": [
{
"challan_no": "MH00123456789012",
"challan_date": "2026-03-14 10:22:00",
"amount": "500",
"challan_status": "Pending",
"offence": "Over Speeding",
"state": "Maharashtra"
}
]
}
}
}
},
"401": {
"description": "Missing, malformed, or revoked X-API-Key.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"call_id": {
"type": "string"
}
}
}
}
}
}
}
},
"402": {
"description": "Wallet balance is below the per-call sale price.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"call_id": {
"type": "string"
}
}
}
}
}
}
}
},
"403": {
"description": "API key is not scoped for this product.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"call_id": {
"type": "string"
}
}
}
}
}
}
}
},
"422": {
"description": "Request body failed schema validation.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"call_id": {
"type": "string"
}
}
}
}
}
}
}
},
"429": {
"description": "Per-key RPS or RPM limit exceeded. See Retry-After.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"call_id": {
"type": "string"
}
}
}
}
}
}
}
},
"502": {
"description": "Upstream vendor rejected our credentials.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"call_id": {
"type": "string"
}
}
}
}
}
}
}
},
"503": {
"description": "No healthy vendor is currently available for this product.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"call_id": {
"type": "string"
}
}
}
}
}
}
}
},
"504": {
"description": "Upstream vendor did not respond within the SLA window.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"call_id": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
}
}
}