Skip to main content
GET
/
v1
/
contacts
/
phone
/
{phoneNumber}
Get Contact by Phone
curl --request GET \
  --url https://api.zavu.dev/v1/contacts/phone/{phoneNumber} \
  --header 'Authorization: Bearer <token>'
{
  "id": "con_abc123",
  "phoneNumber": "+56912345678",
  "countryCode": "CL",
  "availableChannels": ["sms", "whatsapp"],
  "defaultChannel": "whatsapp",
  "verified": true,
  "metadata": {
    "name": "John Doe"
  },
  "createdAt": "2024-01-15T10:00:00.000Z",
  "updatedAt": "2024-01-15T10:00:00.000Z"
}
Retrieve a contact by their phone number.

Path Parameters

phoneNumber
string
required
Phone number in E.164 format (URL encoded). Example: %2B56912345678

Response

{
  "id": "con_abc123",
  "phoneNumber": "+56912345678",
  "countryCode": "CL",
  "availableChannels": ["sms", "whatsapp"],
  "defaultChannel": "whatsapp",
  "verified": true,
  "metadata": {
    "name": "John Doe"
  },
  "createdAt": "2024-01-15T10:00:00.000Z",
  "updatedAt": "2024-01-15T10:00:00.000Z"
}

Example

curl https://api.zavu.dev/v1/contacts/phone/%2B56912345678 \
  -H "Authorization: Bearer zv_live_xxx"
The + character in phone numbers must be URL encoded as %2B.