RC Challan Details API

Endpoint Overview

POST /api/v1/rc/rc-related/challan-details

Description

This API retrieves comprehensive information about vehicle challans (traffic tickets) issued for a specific vehicle. It provides details such as challan numbers, offense descriptions, fine amounts, challan status, and whether the case requires court appearance. The API allows users to search for challan records across multiple state portals simultaneously by providing the vehicle's RC number, chassis number, and engine number.

Key Benefits

Access challan information from multiple states through a single API call

Retrieve detailed offense information including fine amounts and challan status

Identify court-challaned cases that require legal proceedings

Verify pending traffic violations before vehicle purchases or transfers

Use Cases

Automotive

Financial Services

Transportation

Pre-purchase vehicle verification to identify outstanding challans

Fleet management companies monitoring driver compliance with traffic laws

Used car dealerships performing due diligence on vehicles before acquisition

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 Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (JWT format)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
rc_number	String	Yes	Registration Certificate number of the vehicle
chassis_number	String	Yes	Chassis number of the vehicle
engine_number	String	Yes	Engine number of the vehicle
state_only	Boolean	No	When set to true, restricts search to specified states only
state_portal	Array of Enum	No	List of state portals to search (DL, TS, KA, GJ)

Example Request

{
    "rc_number": "HR55AP0244",
    "chassis_number": "MA3JMTB1SPB851591",
    "engine_number": "K10CNC265773",
    "state_only": false,
    "state_portal": [
        "DL",
        "TS",
        "KA",
        "GJ"
    ]
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.client_id	String	Unique identifier for the API request
data.challan_details	Object	Contains challan information
data.challan_details.challans	Array	List of challan records
data.challan_details.blacklist	Array	List of blacklist records (if any)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Additional message (null if successful)
message_code	String	Code indicating the status of the request

Challan Object Structure

Parameter	Type	Description
number	Integer	Serial number of the challan
challan_number	String	Unique challan identification number
offense_details	String	Description of the traffic violation
challan_place	String	Location where the violation occurred
challan_date	String	Date of the challan in YYYY-MM-DD format
state	String	State where the challan was issued
rto	String	Regional Transport Office details
upstream_code	String	Source system identifier
accused_name	String	Name of the person accused of the violation
amount	Float	Fine amount for the violation
challan_status	String	Current status of the challan (e.g., "Pending")
court_challan	Boolean	Indicates if the challan requires court appearance

Example Successful Response

{
    "data": {
        "client_id": "rc_related_UgaxohwEraUGgovAugEF",
        "challan_details": {
            "challans": [
                {
                    "number": 1,
                    "challan_number": "DL112345678978",
                    "offense_details": "Disobeying Lawful Directions",
                    "challan_place": null,
                    "challan_date": "2024-01-25",
                    "state": "DL",
                    "rto": null,
                    "upstream_code": "CENTRAL",
                    "accused_name": "MUNNA BHAIYA",
                    "amount": 19500,
                    "challan_status": "Pending",
                    "court_challan": true
                },
                {
                    "number": 2,
                    "challan_number": "DL12345698789",
                    "offense_details": "Allowing Unauthorised Person To Drive",
                    "challan_place": null,
                    "challan_date": "2023-11-25",
                    "state": "DL",
                    "rto": null,
                    "upstream_code": "CENTRAL",
                    "accused_name": "KALEEN BHAIYA",
                    "amount": 15000,
                    "challan_status": "Pending",
                    "court_challan": true
                },
                {
                    "number": 1,
                    "challan_number": "12345678",
                    "offense_details": "OVER SPEED (Light Motor Vehicle)",
                    "challan_place": "MIRZAPUR",
                    "challan_date": "2023-11-26",
                    "state": "DL",
                    "rto": null,
                    "upstream_code": "DL1",
                    "accused_name": "GUDDU BHAIYA",
                    "amount": 2000,
                    "challan_status": null,
                    "court_challan": null
                },
                {
                    "number": 2,
                    "challan_number": "123456",
                    "offense_details": "Violating stop line",
                    "challan_place": "LODHI ROAD",
                    "challan_date": "2022-08-03",
                    "state": "DL",
                    "rto": null,
                    "upstream_code": "DL1",
                    "accused_name": "RATI SHANKAR SHUKLA",
                    "amount": 500,
                    "challan_status": null,
                    "court_challan": null
                }
            ],
            "blacklist": []
        }
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid RC Number

Authentication Error

{
    "status_code": 422,
    "success": false,
    "message": "Verification Failed.",
    "message_code": "verification_failed"
}

The provided RC number format is invalid or does not conform to the expected pattern.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Validate and sanitize all user inputs before sending them to the API

Implement proper error handling to prevent sensitive information exposure

User Experience Guidelines

Implement caching strategies to improve response times for frequently accessed data

Display challan information in a user-friendly format, grouping by state or date

Clearly indicate court-challaned cases that require legal proceedings

Provide clear instructions for users on how to resolve pending challans

Code Samples

cURL

Python

Node.js

Related APIs

RC Details API: Provides comprehensive vehicle registration information

RC Fitness API: Retrieves vehicle fitness certificate details

RC Ownership Transfer API: Provides vehicle ownership transfer history

RC Hypothecation API: Retrieves vehicle loan and hypothecation details

Compliance and Legal Considerations

This API provides access to traffic violation records which may contain personal information. Ensure compliance with data protection regulations when storing, processing, or displaying this data. The information should only be used for legitimate purposes such as vehicle verification, legal proceedings, or authorized administrative functions. Unauthorized use of this data may violate privacy laws and regulations.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/rc/rc-related/challan-details' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "rc_number": "HR55AP0244", "chassis_number": "MA3JMTB1SPB851591", "engine_number": "K10CNC265773", "state_only": false, "state_portal": [ "DL", "TS", "KA", "GJ" ] }'

{ "data": { "client_id": "rc_related_UgaxohwEraUGgovAugEF", "challan_details": { "challans": [ { "number": 1, "challan_number": "DL112345678978", "offense_details": "Disobeying Lawful Directions", "challan_place": null, "challan_date": "2024-01-25", "state": "DL", "rto": null, "upstream_code": "CENTRAL", "accused_name": "MUNNA BHAIYA", "amount": 19500, "challan_status": "Pending", "court_challan": true }, { "number": 2, "challan_number": "DL12345698789", "offense_details": "Allowing Unauthorised Person To Drive", "challan_place": null, "challan_date": "2023-11-25", "state": "DL", "rto": null, "upstream_code": "CENTRAL", "accused_name": "KALEEN BHAIYA", "amount": 15000, "challan_status": "Pending", "court_challan": true }, { "number": 1, "challan_number": "12345678", "offense_details": "OVER SPEED (Light Motor Vehicle)", "challan_place": "MIRZAPUR", "challan_date": "2023-11-26", "state": "DL", "rto": null, "upstream_code": "DL1", "accused_name": "GUDDU BHAIYA", "amount": 2000, "challan_status": null, "court_challan": null }, { "number": 2, "challan_number": "123456", "offense_details": "Violating stop line", "challan_place": "LODHI ROAD", "challan_date": "2022-08-03", "state": "DL", "rto": null, "upstream_code": "DL1", "accused_name": "RATI SHANKAR SHUKLA", "amount": 500, "challan_status": null, "court_challan": null } ], "blacklist": [] } }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

RC Challan

RC Challan Details API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Challan Object Structure#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses