Legacy API Notice: This documentation covers the Legacy Sent API (v2). While this API remains fully supported, we recommend new integrations use the latest Sent API v3 for enhanced features, improved performance, and long-term support.

Get contact by ID for authenticated customer

Retrieves a specific contact by their unique identifier for the authenticated customer. The customer ID is extracted from the authentication token. Returns detailed contact information including phone number and creation timestamp.

GET
/v2/contacts/id

Query Parameters

id*string

The unique identifier (GUID) of the resource to retrieve

Formatuuid

Response Body

application/json

curl -X GET "https://api.sent.dm/v2/contacts/id?id=6ba7b810-9dad-11d1-80b4-00c04fd430c8"
{
  "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "phoneNumber": "+1234567890",
  "formatE164": "+1234567890",
  "formatInternational": "+1 234-567-890",
  "formatNational": "(234) 567-890",
  "formatRfc": "tel:+1-234-567-890",
  "countryCode": "1",
  "regionCode": "US",
  "availableChannels": "sms,whatsapp",
  "defaultChannel": "sms"
}
Empty
Empty

Get paginated contacts for authenticated customer GET

Retrieves a paginated list of contacts for the authenticated customer. Supports server-side pagination with configurable page size. The customer ID is extracted from the authentication token.

Get contact by phone number for authenticated customer GET

Retrieves a contact by their phone number for the authenticated customer. Phone number should be in international format (e.g., +1234567890). The customer ID is extracted from the authentication token.