Get lead

Get detailed lead information by ID.

GET/api/leads/{lead_id}

HTTP referenceScope leads:readUpdated April 25, 2026

This page documents the canonical HTTP contract for this endpoint.

Path parameters

lead_idrequired
string
Lead ID.

Name	Type	Description
lead_idrequired	string	Lead ID.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Missing leads:read scope.
404	Lead not found.

Example

bash

curl -X GET "https://app.autotouch.ai/api/leads/67c4b113b4dd8f2d4999f0f1" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
    "id": "67c4b113b4dd8f2d4999f0f1",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "email_addresses": [
      { "address": "ada@analyticalengines.com", "primary": true }
    ],
    "lead_status": "new",
    "company_id": "67c4b2dcb4dd8f2d4999f12a",
    "company_domain": "analyticalengines.com"
  }