GET /api/v1/queues — Look Up Queue Entries

Query the campaign action queue by audience_id, member_id, or profile_url. Always include campaign_id. Use before retrying a failed action.

Before retrying a failed campaign action, look up the queue entry to confirm its current state and obtain the queue ID. The queue lookup endpoint accepts exactly one identifier per request alongside the required campaign ID.

Endpoint

GET /api/v1/queues

Query Parameters

campaign_id · integer · required

The campaign ID the queued action belongs to.

audience_id · integer

The audience ID to look up. Provide exactly one of audience_id, member_id, or profile_url.

member_id · string

The member ID to look up. Provide exactly one of audience_id, member_id, or profile_url.

profile_url · string

The profile URL to look up. Provide exactly one of audience_id, member_id, or profile_url.

You must provide campaign_id plus exactly one of audience_id, member_id, or profile_url.

Examples

Lookup by audience_id

curl -X GET 'https://reachowl.com/api/v1/queues?campaign_id=1&audience_id=42' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

Lookup by member_id

curl -X GET 'https://reachowl.com/api/v1/queues?campaign_id=1&member_id=abc123' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

Lookup by profile_url

curl -X GET 'https://reachowl.com/api/v1/queues?campaign_id=1&profile_url=https%3A%2F%2Ffacebook.com%2Fjohn.doe' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

Response Example

{
  "id": 99,
  "campaign_id": 1,
  "audience_id": 42,
  "member_id": "abc123",
  "profile_url": "https://facebook.com/john.doe",
  "status": "failed",
  "message": "Failed to send message",
  "created_at": "2024-01-15T10:30:00Z"
}

Error Responses

Status	Description
401	Unauthorized
404	Queue entry not found
422	Missing required parameters or multiple identifiers provided