Feel free to reach techsupport@surepass.io for any technical support or guidance.
RC Challan Advanced
Production
https://kyc-api.surepass.app
Production
https://kyc-api.surepass.app
POST
https://kyc-api.surepass.app
RC Challan Advanced
Description
Key Benefits
Use Cases
Fintech & Insurance
RTO & Law Enforcement
Vehicle Resale & Rentals
Technical Implementation
Authentication
All API requests require authentication using a JWT Bearer token. Authentication follows these steps:Obtain API Credentials: Register with Surepass to receive your API key. Generate JWT Token: Use your API key to generate a JWT token. Include in Requests: Add the token to the Authorization header as Different authentication tokens are used for sandbox and production environments: Sandbox: Production:
1.
2.
3.
Bearer TOKEN.https://sandbox.surepass.iohttps://kyc-api.surepass.ioRequest Parameters
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token |
| Content-Type | Yes | application/json |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| rc_number | string | Yes | Vehicle's Registration Certificate No |
Example Request
{
"rc_number": "MP30P8880"
}Process Response
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| client_id | string | Client identifier used for the request |
| rc_number | string | RC number associated with the challans |
| challan_details | List | List of challan objects |
| challan_number | string | Unique identifier of each challan |
| offense_details | string | Summary of main offense |
| offense_details_list | List | Detailed offense data including codes, penalties, and sections |
| challan_date | string | Date of the challan |
| challan_status | string | Current status (Paid, Pending, Court Pending) |
| court_challan | boolean | Indicates if challan is court-related |
| court_name | string | Name of court (if applicable) |
| amount | string | Total penalty amount |
Example Successful Response
{
"data": {
"client_id": "CLIENT_IN_789456123",
"rc_number": "MH12DE3456",
"challan_details": [
{
"number": 1,
"challan_number": "MH/TRF/2024/045678",
"offense_details": "Over speeding - Exceeding speed limit by 25 kmph in 60 kmph zone",
"challan_place": "Western Express Highway, Andheri East, Mumbai",
"offense_details_list": [
{
"offense_name": "Over Speeding"
}
],
"challan_date": "2024-03-15",
"challan_date_time": "2024-03-15T14:30:45",
"state": "MH",
"rto": "Pune West (MH-12)",
"accused_name": "Rajesh Kumar Sharma",
"amount": "3000",
"challan_status": "Pending",
"court_challan": false,
"court_name": null,
"upstream_code": "MHTRP_2024_3456789"
},
]
},
"status_code": 200,
"success": true,
"message": null,
"message_code": "success"
}Possible Error Responses
Unauthorized
{
"data": null,
"error": null,
"message": "Your token is invalid. Please ensure that correct token is being used.",
"status_code": 401,
"success": false,
"message_code": "invalid_token"
}
JWT token is missing, expired, or invalid.Security Recommendations
- Store JWT tokens securely and rotate periodically. - Avoid exposing RC numbers and tokens in client-side code. - Use HTTPS for all requests to protect sensitive information. User Experience Guidelines
- Display human-readable challan statuses (e.g., "Paid", "Pending"). - Inform users about next steps for court-related challans. Code Samples
cURL
Python
Node.js
Related APIs
Compliance and Legal Considerations
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://kyc-api.surepass.app/api/v1/rc/rc-related/challan-advanced' \
--header 'Content-Type: application/json' \
--data-raw '{
"rc_number": "HR55AP0244"
}'Response Response Example
{
"data": {
"client_id": "rc_challan_advanced_fZjEyLJOVdtgBWbWBgTA",
"rc_number": "HR55AP0244",
"challan_details": [
{
"number": 1,
"challan_number": "MH114168240703225216",
"offense_details": "Reflectors not fitted",
"challan_place": "",
"offense_details_list": [
{
"offense_name": "Reflectors not fitted"
}
],
"challan_date": "2024-07-03",
"challan_date_time": "2024-07-03T22:52:16",
"state": "MH",
"rto": "",
"accused_name": "M***J",
"amount": "1000",
"challan_status": "Disposed",
"court_challan": false,
"court_name": "",
"upstream_code": "CENTRAL_3"
},
{
"number": 2,
"challan_number": "DL18830230525181743",
"offense_details": "Improper or Obstructive Parking",
"challan_place": "SHANKAR MARKEET",
"offense_details_list": [
{
"offense_name": "Improper or Obstructive Parking"
},
{
"offense_name": "Disobeying Lawful Directions"
},
{
"offense_name": "Permit Violation"
},
{
"offense_name": "Driving Without Licence"
},
{
"offense_name": "Misbehavior with Police Officer"
}
],
"challan_date": "2023-05-25",
"challan_date_time": "2023-05-25T18:17:43",
"state": "DL",
"rto": "",
"accused_name": "Y***F",
"amount": "2000",
"challan_status": "Disposed",
"court_challan": true,
"court_name": "MS PADMA LANDOL, MM-04",
"upstream_code": "CENTRAL_3"
},
{
"number": 3,
"challan_number": "DL18830230525182918",
"offense_details": "Permit Violation",
"challan_place": "SHANKAR MARKEET",
"offense_details_list": [
{
"offense_name": "Permit Violation"
},
{
"offense_name": "Allowing Unauthorised Person To Drive"
}
],
"challan_date": "2023-05-25",
"challan_date_time": "2023-05-25T18:17:43",
"state": "DL",
"rto": "",
"accused_name": "E*T R**T A C*R P*****E L*****D",
"amount": "15000.00",
"challan_status": "Disposed",
"court_challan": true,
"court_name": "MS PADMA LANDOL, MM-04",
"upstream_code": "CENTRAL_3"
},
{
"number": 4,
"challan_number": "DL6683250326083652",
"offense_details": "NO PARKING/ IMPROPER PARKING",
"challan_place": "KASHMERE GATE",
"offense_details_list": [
{
"offense_name": "NO PARKING/ IMPROPER PARKING"
}
],
"challan_date": "2025-03-26",
"challan_date_time": "2025-03-26T08:36:52",
"state": "DL",
"rto": "TRANSPORT DEPARTMENT",
"accused_name": "E*T R**T A C*R P*****E L*****D",
"amount": "1500",
"challan_status": "Pending",
"court_challan": true,
"court_name": "MS. GOWRI REGHUNATH JMFC",
"upstream_code": "CENTRAL_3"
},
{
"number": 5,
"challan_number": "DL60154250303135607",
"offense_details": "Advertisements on Vehicle",
"challan_place": "CENTUR HOTEL RED LIGHT",
"offense_details_list": [
{
"offense_name": "Advertisements on Vehicle"
}
],
"challan_date": "2025-03-03",
"challan_date_time": "2025-03-03T13:56:07",
"state": "DL",
"rto": "South",
"accused_name": "K*****A K***R",
"amount": "1500",
"challan_status": "Pending",
"court_challan": true,
"court_name": "SH. MAYANK SINGHAL , MM-02 - IGI",
"upstream_code": "CENTRAL_3"
},
{
"number": 6,
"challan_number": "DL6722241121105830",
"offense_details": "NO PARKING/ IMPROPER PARKING",
"challan_place": "ISBT KASHMIRI GATE AREA",
"offense_details_list": [
{
"offense_name": "NO PARKING/ IMPROPER PARKING"
}
],
"challan_date": "2024-11-21",
"challan_date_time": "2024-11-21T10:58:30",
"state": "DL",
"rto": "TRANSPORT DEPARTMENT",
"accused_name": "E*T R**T A C*R P*****E L*****D",
"amount": "500",
"challan_status": "Pending",
"court_challan": true,
"court_name": "MS. GOWRI REGHUNATH JMFC",
"upstream_code": "CENTRAL_3"
},
{
"number": 7,
"challan_number": "DL19788241111134111",
"offense_details": "Advertisements on Vehicle",
"challan_place": "PULLMEN",
"offense_details_list": [
{
"offense_name": "Advertisements on Vehicle"
}
],
"challan_date": "2024-11-11",
"challan_date_time": "2024-11-11T13:41:11",
"state": "DL",
"rto": "Outer",
"accused_name": "K*****A K***R",
"amount": "1500",
"challan_status": "Pending",
"court_challan": true,
"court_name": "SH. MAYANK SINGHAL , MM-02 - IGI",
"upstream_code": "CENTRAL_3"
},
{
"number": 8,
"challan_number": "DL5206498240904035905",
"offense_details": "WITHOUT VALID POLLUTION CERTIFICATE",
"challan_place": "MODEL TOWN",
"offense_details_list": [
{
"offense_name": "WITHOUT VALID POLLUTION CERTIFICATE"
}
],
"challan_date": "2024-08-07",
"challan_date_time": "2024-08-07T09:43:00",
"state": "DL",
"rto": "TRANSPORT DEPARTMENT",
"accused_name": "E*T R**T A C*R P*****E L*****D",
"amount": "10000",
"challan_status": "Pending",
"court_challan": true,
"court_name": "MS. SHRADDHA SRIVASTAVA JMFC",
"upstream_code": "CENTRAL_3"
},
{
"number": 9,
"challan_number": "DL18210240402183010",
"offense_details": "Violation of Mandatory Signs(One Way,No Right Turn)",
"challan_place": "NSG RED LIGHT",
"offense_details_list": [
{
"offense_name": "Violation of Mandatory Signs(One Way,No Right Turn)"
}
],
"challan_date": "2024-04-02",
"challan_date_time": "2024-04-02T18:30:10",
"state": "DL",
"rto": "South",
"accused_name": "D*******U J**N",
"amount": "500",
"challan_status": "Pending",
"court_challan": true,
"court_name": "Sh. MAYANK SINGHAL , MM-4",
"upstream_code": "CENTRAL_3"
},
{
"number": 10,
"challan_number": "DL214966240330180106",
"offense_details": "Advertisements on Vehicle",
"challan_place": "AFRICA AVANU",
"offense_details_list": [
{
"offense_name": "Advertisements on Vehicle"
}
],
"challan_date": "2024-03-30",
"challan_date_time": "2024-03-30T18:01:06",
"state": "DL",
"rto": "South West",
"accused_name": "D*******U J**N",
"amount": "500",
"challan_status": "Pending",
"court_challan": true,
"court_name": "Mr. Divyam Lila LD. ,MM-04",
"upstream_code": "CENTRAL_3"
},
{
"number": 11,
"challan_number": "HR46416240304014396",
"offense_details": "35. Violation of road marking",
"challan_place": "Iffco_Chowk_Metro,From_Hudda_Metro_Lane2",
"offense_details_list": [
{
"offense_name": "35. Violation of road marking"
}
],
"challan_date": "2024-02-19",
"challan_date_time": "2024-02-19T17:19:42",
"state": "HR",
"rto": "Gurgaon",
"accused_name": "E*T R**T A C*R P*****E L*****D",
"amount": "500",
"challan_status": "Pending",
"court_challan": true,
"court_name": "sec53 ps area",
"upstream_code": "CENTRAL_3"
}
]
},
"status_code": 200,
"success": true,
"message": null,
"message_code": "success"
}Request
Body Params application/json