Get contact

Read one contact with its 100 most recent calls.

GEThttps://api.tried.com.au/get-contact/{id}

Returns one contact and the calls linked to it, newest first, up to 100. To look a contact up by number, use Get contact by phone.

Request#

Field	Type	Required	Description
`id`	string	Yes	Path parameter. The `contact_id`.

Example request#

curl https://api.tried.com.au/get-contact/contact_4b8e2f1a9c3d5e7f6a0b2c4d \
  -H "Authorization: Bearer $TRIED_API_KEY"

const id = "contact_4b8e2f1a9c3d5e7f6a0b2c4d";
const res = await fetch(`https://api.tried.com.au/get-contact/${id}`, {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const contact = await res.json();

import os, requests

contact_id = "contact_4b8e2f1a9c3d5e7f6a0b2c4d"
res = requests.get(
    f"https://api.tried.com.au/get-contact/{contact_id}",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
contact = res.json()

Response#

200 OK

The call object below is shortened. Each item in calls has every field of Get call plus agent_name.

{
  "contact_id": "contact_4b8e2f1a9c3d5e7f6a0b2c4d",
  "phone_number": "+61412345678",
  "first_name": "Sam",
  "last_name": "Nguyen",
  "email": "sam@example.com",
  "custom_fields": { "plan": "Pro" },
  "do_not_call": false,
  "created_timestamp": 1760850000000,
  "last_modification_timestamp": 1760853600000,
  "calls": [
    {
      "call_id": "call_7c1d2e3f4a5b6c7d8e9f0a1b",
      "call_type": "phone_call",
      "agent_id": "agent_3e4f5a6b7c8d9e0f1a2b3c4d",
      "agent_version": 2,
      "agent_name": "Reception",
      "call_status": "ended",
      "direction": "inbound",
      "from_number": "+61412345678",
      "to_number": "+61291234567",
      "start_timestamp": 1760853000000,
      "end_timestamp": 1760853095000,
      "duration_ms": 95000,
      "disconnection_reason": "user_hangup",
      "contact_id": "contact_4b8e2f1a9c3d5e7f6a0b2c4d"
    }
  ]
}

Field	Type	Description
`calls`	array	Up to 100 linked calls, newest first.

The contact fields are described in Create contact. This endpoint does not return contact memory; use Get contact memory.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `calls` scope.
`404`	`Contact <id> not found`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Same path and method as Retell. The response shape differs: Tried adds the calls array and does not include contact memory.