---
title: "List campaigns"
method: GET
path: "/v1/campaigns"
tags: ["Campaigns"]
---

# List campaigns

`GET /v1/campaigns`

## Request

- Base URL: `https://api.abm.dev`
- URL: `https://api.abm.dev/v1/campaigns`
- Auth: API key in header `X-API-Key`

Return a paginated list of campaigns for the current organization.

## Query parameters

- `status` 'draft' | 'processing' | 'completed' | 'failed' | 'cancelled'
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of campaigns

- object
  - `items` Campaign[]
    - `id` string, uuid
    - `name` string
    - `status` 'draft' | 'processing' | 'completed' | 'failed' | 'cancelled'
    - `source_type` 'hubspot_list' | 'upload' | 'manual'
    - `total_companies` integer
    - `companies_completed` integer
    - `total_candidates_found` integer
    - `credits_used` integer
    - `created_at` string, date-time
    - `completed_at` string, date-time
  - `total` integer

---

[API](https://skmtc.dev/abm/apis/abm-dev-api.md) · [All operations](https://skmtc.dev/abm/apis/abm-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/abm/apis/abm-dev-api/revisions/970c68654961?raw)