GET /api/v1/campaigns, List Campaigns

Returns a paginated list of campaigns for the authenticated user team. Accepts optional team_id, page, and per_page query parameters.

Use this endpoint to retrieve all campaigns that belong to your team. The response is paginated so you can list large campaign sets efficiently.

Query parameters

page · integer · default: "1"

Page number to retrieve.

per_page · integer · default: "15"

Number of campaigns to return per page.

team_id · integer

Team ID to scope the listing. Omit to use the default team associated with your auth token.

Example request

curl -X GET "https://reachowl.com/api/v1/campaigns?page=1&per_page=15" \
  -H "Authorization: Bearer <token>"

Example response

{
  "data": [
    {
      "id": 101,
      "name": "Q3 Outreach",
      "platform": "facebook",
      "action_type": "friend_request",
      "audience_type": "group",
      "post_url": "https://facebook.com/groups/example",
      "status": 1,
      "limit": 30,
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-12T10:30:00Z"
    }
  ],
  "current_page": 1,
  "per_page": 15,
  "total": 1
}

data · array

List of campaign objects.

current_page · integer

The current page number returned.

per_page · integer

Number of items returned per page.

total · integer

Total number of campaigns available.