Endpoint
GET https://api.cortado.pro/api/v1/ext/leads/{id}
Request
curl -H "Authorization: Bearer cort_your_key_here" \
https://api.cortado.pro/api/v1/ext/leads/8f14e45f-ceea-467a-9e6a-1f2b3c4d5e6f
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | UUID | The lead’s ID. Copy it from the lead’s URL in Cortado. |
Response
{
"id": "8f14e45f-ceea-467a-9e6a-1f2b3c4d5e6f",
"organization_id": "3b1c9a2e-77d4-4c0b-9f61-2a5e8d3f4c11",
"contact_id": "c0ffee00-1111-2222-3333-444455556666",
"stage": "QUOTE_SENT",
"event_type_key": "wedding",
"event_location": "Cincinnati, OH",
"referrer": null,
"assigned_to": null,
"booking_id": null,
"tags": ["HOT_LEAD"],
"events": [
{
"id": "aa11bb22-cc33-dd44-ee55-ff6677889900",
"event_date": "2026-10-05T18:30:00Z",
"event_length_hours": 4,
"event_guests": 40,
"event_timezone": "America/New_York",
"event_type_key": null,
"event_location": "Cincinnati, OH"
}
],
"contact": {
"id": "c0ffee00-1111-2222-3333-444455556666",
"first_name": "Ada",
"last_name": "Lovelace",
"email": "ada@example.com",
"phone_number": null
},
"quote_total": 1250.5,
"notes_count": 2,
"tasks_count": 0,
"quotes_count": 1,
"archived_at": null,
"created_at": "2026-09-01T14:02:11Z",
"updated_at": "2026-09-03T09:45:00Z"
}
Fields
| Field | Type | Description |
|---|---|---|
id | string | The lead’s UUID |
organization_id | string | The organization the lead belongs to |
contact_id | string | UUID of the contact who submitted the inquiry |
stage | string | Pipeline stage — see below |
event_type_key | string | null | The event type the customer selected |
event_location | string | null | Location on the lead itself |
referrer | string | null | Where the customer came from, when known |
source | object | Raw attribution data. Omitted when there is none |
assigned_to | string | null | UUID of the assigned staff member |
booking_id | string | null | Set once the lead is converted to a booking |
tags | array of string | Tags applied to the lead, e.g. HOT_LEAD |
events | array | The events the customer requested — see below |
contact | object | null | Summary of the attached contact |
quote_total | number | null | Total of the lead’s quote, when one exists |
notes_count | integer | Number of notes on the lead |
tasks_count | integer | Number of tasks on the lead |
quotes_count | integer | Number of quotes on the lead |
archived_at | string | null | When the lead was archived |
created_at | string | When the lead was created |
updated_at | string | When the lead was last changed |
Stage Values
| Value | Meaning |
|---|---|
NEW | Just arrived, not yet worked |
IN_PROGRESS | Being actively worked |
QUOTE_SENT | A quote has gone out |
ACCEPTED | The customer accepted |
REJECTED | The customer declined |
STALE | No movement for a while |
Event Object
| Field | Type | Description |
|---|---|---|
id | string | The event’s UUID |
event_date | string | null | Start date and time, in UTC |
event_length_hours | number | null | Requested duration in hours |
event_guests | integer | null | Expected guest count |
event_timezone | string | null | IANA timezone, e.g. America/New_York |
event_type_key | string | null | Event type for this specific event |
event_location | string | null | Where this event takes place |
Contact Object
| Field | Type | Description |
|---|---|---|
id | string | The contact’s UUID |
first_name | string | First name |
last_name | string | Last name |
email | string | null | Email address |
phone_number | string | null | Phone number |
contact_id with Get a Contact to fetch the contact’s custom fields.
Errors
| Status | error | Cause |
|---|---|---|
400 | invalid_id | {id} is not a valid UUID |
401 | missing_api_key / invalid_api_key | Missing, malformed, or revoked key |
403 | api_access_disabled | API access is off for the organization |
404 | not_found | No such lead, or it belongs to another organization |
429 | — | Rate limit exceeded |