> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```http theme={null}
GET /api/v1/queues
```

## Query Parameters

<ParamField query="campaign_id" type="integer" required>
  The campaign ID the queued action belongs to.
</ParamField>

<ParamField query="audience_id" type="integer">
  The audience ID to look up. Provide exactly one of `audience_id`, `member_id`, or `profile_url`.
</ParamField>

<ParamField query="member_id" type="string">
  The member ID to look up. Provide exactly one of `audience_id`, `member_id`, or `profile_url`.
</ParamField>

<ParamField query="profile_url" type="string">
  The profile URL to look up. Provide exactly one of `audience_id`, `member_id`, or `profile_url`.
</ParamField>

<Note>
  You must provide `campaign_id` plus exactly one of `audience_id`, `member_id`, or `profile_url`.
</Note>

## Examples

### Lookup by audience\_id

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```json theme={null}
{
  "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 |