> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seleqt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns list

## GET /api/v1/campaigns/

Returns a list of campaigns with optional workspace filtering.

**Authentication:** Session-based (JWT Cookie) OR API Key (X-API-Key header)

### Query Parameters

* `workspace_id` (string, optional): Filter campaigns by workspace
  * Omit parameter: Returns campaigns from current workspace
  * `workspace_id=123`: Returns campaigns from workspace 123 (if user has access)
  * `workspace_id=ALL`: Returns campaigns from all workspaces user has access to

### Security

Users can only access campaigns from workspaces they are linked to via `linked_workspaces`.

### Response

```json theme={null}
{
  "campaigns": [
    {
      "id": 123,
      "name": "My Campaign",
      "status": "ACTIVE",
      "workspace_id": 340,
      "timezone": "Europe/Amsterdam",
      "language": "en",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "prospect_count": 150
    }
  ]
}
```

### Examples

**Using API Key (recommended for integrations):**

```bash theme={null}
# Get campaigns from current workspace
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/" \
  -H "X-API-Key: your_api_key_here"

# Get campaigns from specific workspace
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/?workspace_id=340" \
  -H "X-API-Key: your_api_key_here"

# Get campaigns from all workspaces
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/?workspace_id=ALL" \
  -H "X-API-Key: your_api_key_here"
```

**Using Session Cookie (for web apps):**

```bash theme={null}
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/" \
  -H "Cookie: sessionid=your_session_id"
```

### Error Responses

**403 Forbidden** - User doesn't have access to specified workspace:

```json theme={null}
{
  "error": "Access denied"
}
```