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 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

page*integer

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

Formatint32
pageSize*integer

The number of items per page. Default is 20.

Formatint32

Response Body

application/json

curl -X GET "https://api.sent.dm/v2/contacts?page=0&pageSize=20"
{
  "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