Challanwala API Docs

Generate an API secret, pick an environment, and make your first authenticated request.

1. Generate your API secret

Your organization admin can generate the API secret from the Challanwala CMS organization settings area.

Recommended flow:

Open the organization API access settings.
Confirm the required API service is enabled for your organization.
Generate a new production API secret.
Copy the secret immediately and store it in a secure secret manager.

Shown only once

The API secret is shown only once at creation time. If it is lost, delete the existing secret and generate a new one.

2. Pick your environment

Use the environment switcher to keep examples aligned with the host you are integrating against.

Testing environment

https://cms-staging.challanwala.com

Recommended while wiring up and validating your integration.

3. Send your first request

The easiest first call is the vehicle-type metadata endpoint.

cURL request

curl --request GET 'https://cms-staging.challanwala.com/api/v1/organization-api/metadata/rc-types' \  --header 'Authorization: Bearer YOUR_API_SECRET'

JavaScript request

const response = await fetch('https://cms-staging.challanwala.com/api/v1/organization-api/metadata/rc-types', {  method: 'GET',  headers: {    Authorization: 'Bearer YOUR_API_SECRET',  },});const data = await response.json();console.log(data);

Example response

{"success": true,"data": [  {    "value": "LEASE",    "label": "Lease"  },  {    "value": "PRIVATE_CAR",    "label": "Private Car"  }]}

4. Prepare metadata before search

For a brand new vehicle search, you should usually collect:

rcType from the vehicle type list
cityId from your organization location list

These values are required when the searched vehicle is not already known under your organization.

5. Move into challan search

Once auth is working, the next practical endpoint is challan search:

Read Authentication

Understand bearer tokens, rotation, and common auth failures.

Open Challan Search

See request rules, response fields, and first-search behavior.

Quickstart