---
title: "campaign_status: Campaign status | distribution.tech"
description: "With campaign_id: where that campaign stands (its stage, as stage_id draft, sent, plan_ready, approved, paid, running, complete or cancelled, the current."
canonical: https://distribution.tech/docs/mcp/tools/campaign-status
generator: md-live-route
generated: 2026-10-21T11:46:40.030Z
---

# campaign_status: Campaign status | distribution.tech
-   [Getting started](https://distribution.tech/docs)
-   [API reference](https://distribution.tech/docs/api)
-   [MCP and agents](https://distribution.tech/docs/agents)
-   [Changelog](https://distribution.tech/docs/changelog)

Search the docs

Docs

-   Agents ›

    -   [Run a campaign with your agent](https://distribution.tech/docs/agents)
    -   [MCP server](https://distribution.tech/docs/mcp)

-   MCP tools ›

    -   [inventory](https://distribution.tech/docs/mcp/tools/inventory)
    -   [resolve\_audience](https://distribution.tech/docs/mcp/tools/resolve-audience)
    -   [campaign\_status](https://distribution.tech/docs/mcp/tools/campaign-status)
    -   [evidence](https://distribution.tech/docs/mcp/tools/evidence)
    -   [results](https://distribution.tech/docs/mcp/tools/results)
    -   [brain\_get](https://distribution.tech/docs/mcp/tools/brain-get)
    -   [creators\_search](https://distribution.tech/docs/mcp/tools/creators-search)
    -   [creator\_get](https://distribution.tech/docs/mcp/tools/creator-get)
    -   [creator\_ask\_price](https://distribution.tech/docs/mcp/tools/creator-ask-price)
    -   [plan\_quote](https://distribution.tech/docs/mcp/tools/plan-quote)
    -   [create\_campaign](https://distribution.tech/docs/mcp/tools/create-campaign)
    -   [plan\_add\_creator](https://distribution.tech/docs/mcp/tools/plan-add-creator)
    -   [plan\_remove\_creator](https://distribution.tech/docs/mcp/tools/plan-remove-creator)
    -   [plan\_move\_dates](https://distribution.tech/docs/mcp/tools/plan-move-dates)
    -   [plan\_swap\_creator](https://distribution.tech/docs/mcp/tools/plan-swap-creator)
    -   [set\_creator\_guidelines](https://distribution.tech/docs/mcp/tools/set-creator-guidelines)
    -   [approve\_plan](https://distribution.tech/docs/mcp/tools/approve-plan)
    -   [archive\_campaign](https://distribution.tech/docs/mcp/tools/archive-campaign)
    -   [rename\_campaign](https://distribution.tech/docs/mcp/tools/rename-campaign)
    -   [delete\_campaign](https://distribution.tech/docs/mcp/tools/delete-campaign)
    -   [feedback\_send](https://distribution.tech/docs/mcp/tools/feedback-send)
    -   [feedback\_list](https://distribution.tech/docs/mcp/tools/feedback-list)


1.  [distribution](https://distribution.tech/)
2.  / [Docs](https://distribution.tech/docs)
3.  / [MCP tools](https://distribution.tech/docs#mcp)
4.  / campaign\_status

MCP tool

# Campaign status

campaign\_status

With campaign\_id: where that campaign stands (its stage, as stage\_id draft, sent, plan\_ready, approved, paid, running, complete or cancelled, the current.

Copy page as markdown [View .md](https://distribution.tech/docs/mcp/tools/campaign-status.md)

## Overview

With campaign\_id: where that campaign stands (its stage, as stage\_id draft, sent, plan\_ready, approved, paid, running, complete or cancelled, the current plan with its lines, dates, prices and each line's post stage, and the order once signed). Without it: every campaign of yours with its stage.

Server

`https://app.distribution.tech/api/mcp`

Scope

`campaigns:read`

Changes data

No, a read

REST endpoint

[GET /campaigns](https://distribution.tech/docs/api/get-campaigns), [GET /campaigns/{id}](https://distribution.tech/docs/api/get-campaigns-id)

## Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | string (uuid) | No | One campaign. Leave out to list them all. |
| `include_archived` | boolean | No | The list leaves archived campaigns out unless this is true. |

## Call with curl

The server speaks streamable HTTP, so one JSON-RPC `tools/call` request runs the tool. Set `DISTRIBUTION_API_KEY` to a key from Developers with the `campaigns:read` scope; the arguments shown are the required ones.

curl

```
curl -X POST "https://app.distribution.tech/api/mcp" \
  -H "Authorization: Bearer $DISTRIBUTION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "campaign_status",
    "arguments": {}
  }
}'
```

## Result

The answer's `structuredContent` follows the tool's output schema (the same JSON is in its text content). It has these fields:

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | Yes |  |
| `campaign` | string | Yes |  |
| `created_at` | string (date-time) | Yes |  |
| `refunded_at` | string (date-time) or null | Yes | When the order was refunded; null unless it was. |
| `archived_at` | string (date-time) or null | Yes | When the brand archived the campaign; null for a live one. An archived campaign's stage reads Archived, and renaming it or setting its creator guidelines is refused (409 conflict, reason archived). |
| `intent_status` | one of "draft", "ready", null | Yes |  |
| `plan_status` | one of "awaiting\_approval", "approved", null | Yes |  |
| `open_change` | boolean | Yes |  |
| `stage` | one of "Draft", "Sent", "Plan ready", "Approved", "Paid", "Running", "Complete", "Cancelled", "Archived" | Yes |  |
| `stage_id` | one of "draft", "sent", "plan\_ready", "approved", "paid", "running", "complete", "cancelled" | Yes | draft (not sent), sent (no plan yet), plan\_ready (a plan waits for approval), approved (signed, not paid), paid (the brand's payment cleared, no post started), running (a post is scheduled, live or delayed), complete (every post has its proof), cancelled (the order was cancelled or refunded). |
| `plan` | null or object | Yes |  |
| `order` | null or object | Yes |  |
| `creator_guidelines` | null or object | Yes |  |

structuredContent, every field with its type

```
{
  "id": "<uuid>",
  "campaign": "<string>",
  "created_at": "<date-time>",
  "refunded_at": "<date-time>",
  "archived_at": "<date-time>",
  "intent_status": "draft",
  "plan_status": "awaiting_approval",
  "open_change": false,
  "stage": "Draft",
  "stage_id": "draft",
  "plan": {
    "id": "<uuid>",
    "version": 0,
    "status": "awaiting_approval",
    "launch_window_start": "<date>",
    "launch_window_end": "<date>",
    "currency": "<string>",
    "sent_at": "<date-time>",
    "approved_at": "<date-time>",
    "total_cents": 0,
    "lines": [
      {
        "id": "<uuid>",
        "channel": "<string>",
        "channel_label": "<string>",
        "slot": "<string>",
        "scheduled_date": "<date>",
        "price_cents": 0,
        "status": "planned",
        "stage_id": "planned",
        "stage": "Planned",
        "proposal": {
          "state": "sending",
          "creator_handle": "<string>",
          "replaced_handle": "<string>",
          "updated_at": "<date-time>"
        }
      }
    ],
    "lines_by_status": {},
    "lines_by_stage": {
      "planned": 0,
      "offered": 0,
      "creator_confirmed": 0,
      "scheduled": 0,
      "live": 0,
      "proof_attached": 0,
      "cancelled": 0
    }
  },
  "order": {
    "payment_state": "<string>",
    "total_cents": 0,
    "currency": "<string>",
    "signed_at": "<date-time>",
    "paid_at": "<date-time>"
  },
  "creator_guidelines": {
    "pitch": "<string>",
    "key_messages": [
      "<string>"
    ],
    "references": [
      "<uri>"
    ],
    "voice": "<string>",
    "dos": [
      "<string>"
    ],
    "donts": [
      "<string>"
    ]
  }
}
```

## Other tools

-   [`inventory`](https://distribution.tech/docs/mcp/tools/inventory): Network coverage
-   [`resolve_audience`](https://distribution.tech/docs/mcp/tools/resolve-audience): Resolve an audience
-   [`evidence`](https://distribution.tech/docs/mcp/tools/evidence): Proof of delivery
-   [`results`](https://distribution.tech/docs/mcp/tools/results): Results
-   [`brain_get`](https://distribution.tech/docs/mcp/tools/brain-get): Company context
-   [`creators_search`](https://distribution.tech/docs/mcp/tools/creators-search): Find creators
-   [`creator_get`](https://distribution.tech/docs/mcp/tools/creator-get): One creator
-   [`creator_ask_price`](https://distribution.tech/docs/mcp/tools/creator-ask-price): Ask for a price
-   [`plan_quote`](https://distribution.tech/docs/mcp/tools/plan-quote): Quote a plan
-   [`create_campaign`](https://distribution.tech/docs/mcp/tools/create-campaign): Start a campaign
-   [`plan_add_creator`](https://distribution.tech/docs/mcp/tools/plan-add-creator): Add a creator
-   [`plan_remove_creator`](https://distribution.tech/docs/mcp/tools/plan-remove-creator): Remove a creator
-   [`plan_move_dates`](https://distribution.tech/docs/mcp/tools/plan-move-dates): Move a plan's dates
-   [`plan_swap_creator`](https://distribution.tech/docs/mcp/tools/plan-swap-creator): Swap a creator
-   [`set_creator_guidelines`](https://distribution.tech/docs/mcp/tools/set-creator-guidelines): Set the creator guidelines
-   [`approve_plan`](https://distribution.tech/docs/mcp/tools/approve-plan): Approve and get the pay link
-   [`archive_campaign`](https://distribution.tech/docs/mcp/tools/archive-campaign): Archive a campaign
-   [`rename_campaign`](https://distribution.tech/docs/mcp/tools/rename-campaign): Rename a campaign
-   [`delete_campaign`](https://distribution.tech/docs/mcp/tools/delete-campaign): Delete a draft campaign
-   [`feedback_send`](https://distribution.tech/docs/mcp/tools/feedback-send): Send feedback
-   [`feedback_list`](https://distribution.tech/docs/mcp/tools/feedback-list): Your feedback

## Get access

Keys are created in Developers once your brand is approved. [Connect an agent](https://distribution.tech/distribution#access) to ask for access, then read [the agent guide](https://distribution.tech/docs/agents) for the full flow.

On this page

-   [Overview](#overview)
-   [Arguments](#arguments)
-   [Call with curl](#curl)
-   [Result](#result)
-   [Other tools](#related)
-   [Get access](#access)

[![distribution.tech](https://distribution.tech/brand/wordmark-light.svg)![distribution.tech](https://distribution.tech/brand/wordmark.svg)](https://distribution.tech/)

Your agent buys your distribution.

Distribution we run for

-   ClickUp
-   Gushwork
-   Tab

Platform

-   [How it works](https://distribution.tech/how-it-works)
-   [Network](https://distribution.tech/network)
-   [Workspace](https://app.distribution.tech/login)
-   [For your agents](https://distribution.tech/distribution)

Solutions

-   [Product launch](https://distribution.tech/solutions/product-launch)
-   [Funding announcement](https://distribution.tech/solutions/funding-announcement)
-   [Feature release](https://distribution.tech/solutions/feature-release)
-   [For brands](https://distribution.tech/for-brands)
-   [For creators](https://distribution.tech/for-creators)

Resources

-   [Blog](https://distribution.tech/blog)
-   [Launch playbook](https://distribution.tech/playbook)
-   [X creator rates](https://distribution.tech/rates/x-creators)

Company

-   [Customers](https://distribution.tech/customers)
-   [Pricing](https://distribution.tech/pricing)
-   [Changelog](https://distribution.tech/changelog)
-   [Build a distribution plan](https://app.distribution.tech/login)
-   [Join the creator network](https://distribution.tech/for-creators#apply)
-   [Log in](https://app.distribution.tech/login)

Legal

-   [Privacy](https://distribution.tech/privacy)
-   [Terms](https://distribution.tech/terms)

© 2026 distribution.tech [Contact: team@distribution.tech](mailto:team@distribution.tech)Cookie settings

Light Dark System