Challanwala API Docs

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

1. Generate your API secret

Production and testing use different key-generation flows:

Production: your organization admin generates the API secret from the Challanwala CMS organization settings area.
Testing: you can generate a dummy staging secret directly from the docs when the environment selector is set to Testing.

Testing only

Generate a staging API secret

This testing route is public and mints a dummy bearer secret for the staging Hono API. It never creates a production organization key.

Sandbox name

The generated secret is shown once here and saved locally in this browser so you can reuse it while testing.

Production 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

/api/v1/staging

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/staging/metadata/rc-types' \  --header 'Authorization: Bearer YOUR_API_SECRET'

JavaScript request

const response = await fetch('https://cms-staging.challanwala.com/api/v1/staging/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 Testing Guide

Generate staging keys, configure staging webhooks, and use the /api/v1/staging replica routes.

Open Challan Search

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

Quickstart