Get contact

GET

api

contacts

{contact_id}

curl -X GET "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab" \
  -H "Authorization: Bearer <token>"

import requests

url = "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"

headers = {
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

const data = await response.json();
console.log(data);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"))
    .header("Authorization", "Bearer <token>")
    .GET()
    .build();

HttpResponse<String> response =
    HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

{
  "id": "7b8f9e2a-4c1d-48ef-9123-bcde456789ab",
  "organization_id": "00000000-0000-0000-0000-000000000001",
  "phone_number": "+14155550199",
  "name": "Jane Doe",
  "tags": [
    "vip",
    "enterprise"
  ],
  "notes": "Met at SaaS Summit 2026",
  "custom_fields": {
    "company": "Acme Corp",
    "deal_size": 25000
  },
  "lifecycle_stage": "qualified",
  "lead_score": 85,
  "owner_id": "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
  "ai_handling": true,
  "last_activity_at": "2026-10-07T14:30:00Z",
  "source": "manual",
  "created_at": "2026-10-07T11:00:00Z",
  "updated_at": "2026-10-07T14:30:00Z"
}

{
  "detail": "Contact not found"
}

{
  "detail": "Unauthorized"
}

Retrieve comprehensive profile information, segmentation tags, custom metadata, and current CRM attributes (lifecycle stage, lead score, assigned owner, AI handling status) for an individual contact by UUID.

Authentication

This endpoint requires Bearer token authentication.

Authorization: Bearer <token>

Header	Type	Required	Description	Format
`Authorization`	`string`	Yes	Scoped organization API key or Bearer JWT token	`Bearer <token>`

Input parameters

string

required

Unique UUID identifier of the contact. Example: 7b8f9e2a-4c1d-48ef-9123-bcde456789ab.

string

required

Bearer token for authentication. Format: Bearer <token>.

Response Fields

string

Unique UUID identifier of the contact.

string

Owning organization UUID.

string

Customer telephone number.

string

Full name of the contact.

string[]

Array of assigned classification tags.

string

Internal context or notes.

object

Key-value dictionary containing arbitrary custom metadata.

string

Current CRM lifecycle stage: new, engaged, qualified, customer, or lost.

integer

Numerical lead qualification score between 0 and 100.

string

UUID of the assigned team member, or null.

boolean

Whether automated AI voice/chat systems handle interactions (true) or human agents (false).

string

ISO 8601 timestamp of the most recent interaction or timeline activity event.

string

Origin channel of the contact (e.g. manual, bulk_upload, inbound_call).

string

ISO 8601 creation timestamp.

string

ISO 8601 modification timestamp.

curl -X GET "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab" \
  -H "Authorization: Bearer <token>"

import requests

url = "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"

headers = {
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

const data = await response.json();
console.log(data);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"))
    .header("Authorization", "Bearer <token>")
    .GET()
    .build();

HttpResponse<String> response =
    HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

{
  "id": "7b8f9e2a-4c1d-48ef-9123-bcde456789ab",
  "organization_id": "00000000-0000-0000-0000-000000000001",
  "phone_number": "+14155550199",
  "name": "Jane Doe",
  "tags": [
    "vip",
    "enterprise"
  ],
  "notes": "Met at SaaS Summit 2026",
  "custom_fields": {
    "company": "Acme Corp",
    "deal_size": 25000
  },
  "lifecycle_stage": "qualified",
  "lead_score": 85,
  "owner_id": "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
  "ai_handling": true,
  "last_activity_at": "2026-10-07T14:30:00Z",
  "source": "manual",
  "created_at": "2026-10-07T11:00:00Z",
  "updated_at": "2026-10-07T14:30:00Z"
}

{
  "detail": "Contact not found"
}

{
  "detail": "Unauthorized"
}

‹ Previous

Update contact

PUT /api/v1/contacts/{contact_id}

Next ›

curl -X GET "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab" \
  -H "Authorization: Bearer <token>"

import requests

url = "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"

headers = {
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

const data = await response.json();
console.log(data);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"))
    .header("Authorization", "Bearer <token>")
    .GET()
    .build();

HttpResponse<String> response =
    HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

{
  "id": "7b8f9e2a-4c1d-48ef-9123-bcde456789ab",
  "organization_id": "00000000-0000-0000-0000-000000000001",
  "phone_number": "+14155550199",
  "name": "Jane Doe",
  "tags": [
    "vip",
    "enterprise"
  ],
  "notes": "Met at SaaS Summit 2026",
  "custom_fields": {
    "company": "Acme Corp",
    "deal_size": 25000
  },
  "lifecycle_stage": "qualified",
  "lead_score": 85,
  "owner_id": "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
  "ai_handling": true,
  "last_activity_at": "2026-10-07T14:30:00Z",
  "source": "manual",
  "created_at": "2026-10-07T11:00:00Z",
  "updated_at": "2026-10-07T14:30:00Z"
}

{
  "detail": "Contact not found"
}

{
  "detail": "Unauthorized"
}

Overview

Agents

Campaigns

Contacts

CRM

Templates

Knowledge Base

Webhooks

Call Logs

Quick Replies

Inbox

Authentication

Input parameters

Response Fields

​Authentication

​Input parameters

​Response Fields

Authentication

Input parameters

Response Fields