Get Lead

Fetches a single lead.

GET/api/v1/leads/{lead_id}

Examples

Request

curl --request GET \
  --url 'https://api.vaanii.ai/api/v1/leads/0484a250-e057-44eb-ab99-6fc26bec4340' \
  --header 'X-API-Key: <your_api_key>'

Response

Possible HTTP status codes for this endpoint, with a representative response body for each. Select a status to preview it.

200 OKSuccessful response

{
  "id": "d17ae67f-d4ff-4a2a-8e90-5c2b3627055c",
  "campaign_id": "8359571c-48cc-429d-91b4-a11005ea0749",
  "first_name": "Sneha",
  "phone_e164": "+919819707683",
  "status": "new",
  "custom_fields": {
    "loan_amount": 1574079,
    "city": "Delhi"
  },
  "calls_count": 0,
  "updated_at": "2026-09-11T23:38:44+05:30",
  "next_scheduled_call": "2026-09-12T04:28:44+05:30"
}

Description

Verifies the lead belongs to your company, then returns it.

Parameters

Path param	Type	Description
`lead_id`	UUID	The lead's ID.

Response — 200 OK

A single Lead Object.

Errors

Status	Detail
`404`	Lead not found or not in your company.