Retrieve a lead

GET https://api.tamio.com/v2/leads/retrieve/{uuid}

Retrieves a single lead by its UUID with full details including contact information, status, priority, assigned teammate, and addresses.

Path Parameters

uuid string*

UUID of the lead to retrieve

Responses

200 Lead retrieved successfully

Lead retrieved successfully

status integer
customer Lead
400 Bad request. Possible `error_code` values:
401 Missing or invalid API key
/leads/retrieve/{uuid}
1const response = await fetch("https://api.tamio.com/v2/leads/retrieve/{uuid}", {
2 headers: {
3 "Authorization": "Bearer YOUR_API_KEY",
4 "Accept": "application/json"
5 }
6});
7const data = await response.json();
Responses
{
  "status": 200,
  "customer": {
    "id": "string",
    "object": "customer",
    "name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "country": "de",
    "locale": "en",
    "phone": "+49 123 456",
    "category": "lead",
    "priority": "normal",
    "lead_status": "new_lead",
    "timezone_offset": "+02:00",
    "teammate_id": "string",
    "created_at": 1700000000,
    "addresses": []
  }
}