Get contact by phone

Look up a contact by its phone number, with memory, call count and last call time.

GEThttps://api.tried.com.au/get-contact-by-phone/{phone_number}

Finds the contact for a phone number. Use it from your own systems when a caller's number is all you have. The number can go in the path or in a phone_number query parameter; both forms return the same result.

GET /get-contact-by-phone/{phone_number}
GET /get-contact-by-phone?phone_number=+61412345678

Request#

Field	Type	Required	Description
`phone_number`	string	Yes	Path parameter, or query parameter on `/get-contact-by-phone`. URL-encode the `+` as `%2B`. Spaces, brackets and hyphens are removed, and the result must be E.164.

Example request#

curl https://api.tried.com.au/get-contact-by-phone/%2B61412345678 \
  -H "Authorization: Bearer $TRIED_API_KEY"

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

import os, requests

res = requests.get(
    "https://api.tried.com.au/get-contact-by-phone",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
    params={"phone_number": "+61412345678"},
)
contact = res.json()

Response#

200 OK

{
  "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,
  "memory": "- 2026-10-18: Asked to move the Tuesday 3pm appointment to Thursday.",
  "memory_updated_timestamp": 1760853700000,
  "memory_conversation_count": 1,
  "call_count": 4,
  "last_call_timestamp": 1760853000000
}

Field	Type	Description
`memory`	string or null	The contact's memory brief. See Get contact memory.
`memory_updated_timestamp`	integer or null	Unix ms of the last memory change.
`memory_conversation_count`	integer	Conversations saved to memory.
`call_count`	integer	Calls linked to the contact.
`last_call_timestamp`	integer or null	Unix ms creation time of the newest linked call.

The other fields are described in Create contact.

Errors#

Status	When
`400`	`phone_number must be E.164, e.g. +61412345678`, or `phone_number is required` on the query form.
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `calls` scope.
`404`	`No contact with <phone_number>`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

The path form matches Retell's path and method. The query form is a Tried addition. The response shape differs: Tried returns memory, call_count and last_call_timestamp.