Basic Challan Search
This service is used for retrieving the Challan details imposed on a vehicle by entering the Vehicle number.
You will need to login before sending the request. You are required to pass the access token received from the login call, as the authorization header in the request.
Vehicle Number is Mandatory parameter to be passed. State Portal is an Optional parameter.
In case you need to get Maharastra Challans, please provide the consent in mhChallanConsentBased parameter and please provide the phone number which is associated with that particular vehicle number in phoneNoForOtpMH parameter. As fetching Maharashtra challans is OTP consent based flow, we will need OTP. For that, Basic Challan Search (MH OTP Entering API) will be used.
Parameter Name | Required/Optional | Description |
Content-Type | Required | application/json |
Authorization | Required | Contains the id parameter returned from the login step |
task | Required | Type of task Performed - "Challan Search" |
essentials | Required | Contains essentials input data |
essentials.vehicleNumber | Required | The vehicle number on which the chalan has been imposed |
essentials.statePortal | Optional | Provide the state parameter in which you want to search for the challan of the specified vehicle. |
essentials.mhChallanConsentBased | Optional | Provide consent to fetch Maharastra Challan |
essentials.phoneNoforOtpMH | Optional | Provide phone number associated with the given vehicle number |
State Portal Field Information
When you search for a paritcular vehicle, by default we will check both central and that particular state's sources.
for e.g When you search for KA vehicle, KA and central source will be checked by default. But, if you want to find if this vehicle has any challans on MP state's sources then you need to pass MP as variable in statePortal field.
Note :- Every extra parameter that you will pass in statePotal field will lead to increase in latency of API as now need to check more sources to get the data.
State | Whether we are covering it (Yes/No) | Whether we need to pass a value in Stateportal field (Yes/No) | Remarks | More Information |
Central (ECHALLAN) | Yes | No | | |
TS | Yes | Yes (TS) | | |
AP | Yes | Yes(AP) | | |
MP | Yes | Yes(MP) | | |
JH | Yes | Yes(JH) | | |
MH | Yes | Yes(MH) | | It has been consent based now. OTP is required for MH state challans |
KA | Yes | Yes(KA) | | |
DL | Yes | Yes(DL_ALL) | DL_1, DL_2, DL_3 can also be passed in a list to speeden up rather than passing DL_ALL. | DL_1 - Delhi challans which are not in Virtual court. DL_2 - Delhi challans which are in Virtual Court Source 1 DL_3 - Delhi challans which are in Virtual Court Source 2 So Delhi by default searches for Central, DL_1, not DL_ALL as DL_2 & DL_3 are slow sources |
ChallanStatus Possible Values :-
- Pending
- Paid
- Not Paid
- Cash
- Disposed
- Null
- Empty Strings
Parameter Name | Description |
id | The unique token returned after login |
patronId | Unique Patron ID |
task | Task to be performed search (here Challan) |
result | This parameter contains the actual output |
result.regNo | Contains vehicle registration number |
result.message | Shows the message "Challan Details Found" |
result.status_code | Shows the status of response |
result.challanDetails.number | Shows the number of challans imposed |
result.challanDetails.challanNumber | Shows the particular challan number |
result.challanDetails.offenseDetails | Contains details of particular offense |
result.challanDetails.challanPlace | Informs about the place where the challan has been imposed |
result.challanDetails.challanDate | Informs about the date when the challan has been imposed Informs about the place where challan has been imposed Informs about the place where challan has been imposed |
result.challanDetails.state | Informs about the State where the challan has been imposed |
result.challanDetails.rto | Contains the details of the RTO Authority |
result.challanDetails.accusedName | Informs about the name of the accused person |
result.challanDetails.amount | Shows the fine amount for infringement |
result.challanDetails.challanStatus | Shows the status of how the challan has been paid eg. cash |
result.challanDetails.court_challan | Whether court challan or not |
result.challanDetails.challanSource | Gives the source of the Challan API |
MhChallanPhoneNumbers | Gives the list of phone numbers associated with the vehicle number provided (Can be seen only when mhChallanConsentBased is true) |
successfulSources | Sources from which we can fetch the challans successfully. |
failedSources | Sources from which we are not able to fetch the challans successfully. |
CODE | MESSAGE |
200 | Successful Response |
400 | Bad Request |
401 | No API key found in request |
409 | Error in getting data |
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected].