Skip to main content
GET
/
api
/
contacts
List Contacts
curl --request GET \
  --url https://api.example.com/api/contacts
{
  "data": [
    {
      "id": "<string>",
      "email": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "company": "<string>",
      "title": "<string>",
      "reply_count": 123,
      "last_reply_at": "<string>",
      "created_at": "<string>"
    }
  ],
  "pagination": {}
}
Fetch all contacts who have replied to your campaigns.

​
Query Parameters

​
client_id
string
Filter contacts by client UUID
​
search
string
Search by email address, name, or company
​
limit
integer
default:"20"
Number of contacts to return (max 100)
​
offset
integer
default:"0"
Number of contacts to skip for pagination

​
Response

​
data
array
Array of contact objects
​
pagination
object
Pagination metadata

​
Examples

curl -X GET "https://app.replyify.ai/api/contacts?limit=20" \
  -H "Authorization: Bearer rpl_your_api_key"

​
Response Example

{
  "data": [
    {
      "id": "contact-abc123",
      "email": "john@example.com",
      "first_name": "John",
      "last_name": "Smith",
      "company": "Example Inc",
      "title": "VP of Sales",
      "reply_count": 3,
      "last_reply_at": "2024-01-15T14:30:00Z",
      "created_at": "2024-01-10T09:00:00Z"
    },
    {
      "id": "contact-def456",
      "email": "jane@acme.com",
      "first_name": "Jane",
      "last_name": "Doe",
      "company": "Acme Corp",
      "title": "Marketing Director",
      "reply_count": 1,
      "last_reply_at": "2024-01-14T11:20:00Z",
      "created_at": "2024-01-14T11:20:00Z"
    }
  ],
  "pagination": {
    "total": 156,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}