GET /api/v1/contacts — List Contacts

Returns a paginated list of contacts generated by your campaigns. Contacts are read-only and cannot be created directly via the API.

The ReachOwl Contacts API lets you list contacts that were generated by your campaigns. Contacts are read-only resources: they are created automatically by running campaigns and cannot be created, updated, or deleted directly via the API.

Endpoint

GET /api/v1/contacts

Query Parameters

team_id · integer · required

The team ID to filter contacts by.

page · integer · default: "1"

The page number for paginated results.

Request Example

curl -X GET 'https://reachowl.com/api/v1/contacts?team_id=1&page=1' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

Response Example

{
  "data": [
    {
      "id": 1,
      "name": "John Doe",
      "email": "[e-mail]",
      "profile_url": "https://facebook.com/john.doe",
      "created_at": "2024-01-15T10:30:00Z",
      "campaign_id": 12
    }
  ],
  "current_page": 1,
  "last_page": 5,
  "per_page": 15,
  "total": 73
}

Contacts are created by campaigns only. There is no endpoint to create or modify contacts directly.

Error Responses

Status	Description
401	Unauthorized - Invalid or missing Bearer token
404	Team not found