Sent LogoSent API Docs

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
/v1/contacts
x-sender-id<token>

In: header

Query Parameters

pageinteger
Formatint32
pageSizeinteger
Formatint32

Header Parameters

x-sender-idstring
Formatguid
x-api-keystring

Response Body

curl -X GET "https://api.sent.dm/v1/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