Get paginated contacts for authenticated customer

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
/v2/contacts

Query Parameters

pageinteger

The page number (zero-indexed). Default is 0.

Formatint32
pageSizeinteger

The number of items per page. Default is 20.

Formatint32

Header Parameters

x-sender-idstring
Formatguid
x-api-keystring

Response Body

application/json

curl -X GET "https://api.sent.dm/v2/contacts?page=0&pageSize=0" \  -H "x-sender-id: string" \  -H "x-api-key: string"
{
  "items": [
    {
      "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"
    },
    {
      "id": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
      "phoneNumber": "+1234567891",
      "formatE164": "+1234567891",
      "formatInternational": "+1 234-567-891",
      "formatNational": "(234) 567-891",
      "formatRfc": "tel:+1-234-567-891",
      "countryCode": "1",
      "regionCode": "US",
      "availableChannels": "sms",
      "defaultChannel": "sms"
    }
  ],
  "totalCount": 150,
  "page": 0,
  "pageSize": 20,
  "totalPages": 8
}
Empty
Empty