Skip to main content

Enquiries API

Manage enquiries (leads) submitted by buyers to suppliers, with WhatsApp notification support.

Endpoints


Create Enquiry

Submit a new enquiry from a buyer to a supplier. Public endpoint — no authentication required. Triggers background WhatsApp/email notifications automatically.

Request Body

Fields

Response 201 Created

Errors


List Enquiries

List enquiries with optional filters. Requires authentication. Results are paginated.

Query Parameters

Status Values

Response 200 OK

Errors


Get Enquiry

Fetch a single enquiry by ID. Requires authentication.

Response 200 OK

Returns the full enquiry object (same shape as Create response).

Errors


Update Enquiry

Update the status or details of an existing enquiry. Requires authentication.

Request Body

Fields

Response 200 OK

Returns the updated enquiry object.

Errors


Verify WhatsApp Number

Check whether a phone number is registered on WhatsApp before sending a message. Public endpoint.

Request Body

Response 200 OK


Background Notifications

When an enquiry is created, background tasks fire automatically:
Notification failures are logged but do not affect the enquiry creation response.

Rate Limits