---
title: "Get a campaign"
method: GET
path: "/api/v1/campaigns/{campaign_id}"
tags: ["Campaigns"]
---

# Get a campaign

`GET /api/v1/campaigns/{campaign_id}`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/campaigns/{campaign_id}`
- Auth: HTTP bearer

The campaign with its settings, emails, senders, follow-up sequences, personal-line setup and `launch_blockers`: what still has to happen before a launch is accepted. `variable_coverage` lists every variable the emails use with the number of people who have no value for it (`missing`). Those people wait at that email until the value exists or the variable gets a default, such as {{company_normalized|your team}}. A variable that nobody has blocks the launch.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:read_counts` |

## Path parameters

- `campaign_id` string, uuid, required

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object
  - `campaign` object
    - `id` string
    - `name` string
    - `status` string
    - `lead_count` integer
    - `queued_count` integer
    - `sent_count` integer
    - `replied_count` integer
    - `positive_reply_count` integer
    - `bounced_count` integer
    - `step_count` integer
    - `inbox_count` integer
    - `daily_limit` integer
    - `default_timezone` string
    - `created_at` string
    - `updated_at` string
    - `url` string
  - `launch_blockers` unknown[]
    - unknown
  - `copy_warnings` unknown[]
    - unknown
  - `emails` object[]
    - `step` integer
    - `subject` string
    - `body` string
    - `delay_days` integer
    - `same_thread` boolean
  - `senders` object[]
    - `email` string
    - `provider` string
    - `status` string
    - `health` string
  - `subsequences` unknown[]
    - unknown

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:read_counts.
- `404`: 404 Not found. `not_found` when the item does not exist in your workspace.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

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