curl --request GET \
  --url https://your-instance.example.com/api/contact-metrics/contacts \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "contacts": [
      {
        "_id": "65c2d0e0f0a0b0c0d0e0f0a0",
        "firstName": "Jane",
        "lastName": "Doe",
        "phoneNumber": "+14155550123",
        "status": "qualified",
        "createdAt": "2026-04-12T08:00:00.000Z",
        "hasOutbound": true,
        "channelTypes": [
          "sms"
        ]
      }
    ],
    "total": 47,
    "page": 1,
    "limit": 25,
    "totalPages": 2
  }
}