Read one campaign's status and how many of its emails are waiting, queued, sending, sent, skipped, replied to or bounced.

GEThttps://api.rankparse.com/v1/outreach/campaigns/:idFreeAPI key

Returns a campaign and the delivery counts of its emails. Use it to answer "how is my campaign doing?".

Path parameters

idstringrequired

The campaign id. An archived campaign or one outside your workspace returns 404 campaign_not_found.

Response

idstring

Campaign id.

namestring

Campaign name.

your_domainstring

The website the links are for.

goalstring | null

The goal note, if any.

statusstring

See Campaign status.

pausedboolean

true while the campaign is paused.

created_atinteger

Unix time in milliseconds.

site_idstring | null

The website the campaign belongs to.

site_hoststring | null

That website's host.

contactsobject

Email counts.

Show properties

totalinteger

Every contact in the campaign.

awaiting_launchinteger

Emails waiting for review or launch. Only these can be rewritten with Update contacts.

queuedinteger

Approved and waiting for the hourly sending sweep.

sendinginteger

Being sent right now.

sentinteger

Sent.

skippedinteger

Skipped, for example removed in review or suppressed because the address was emailed before.

repliedinteger

Sent emails marked as replied to. These are also counted in sent.

bouncedinteger

Sent emails marked as bounced. These are also counted in sent.

Errors

HTTP	Code	When
403	`capability_missing`	Your role cannot view outreach.
404	`campaign_not_found`	Not in your workspace, or archived.

Plus the shared errors.

MCP tool: outreach_get_campaign (accepts campaign_id).

Get prospecting context

Capacity, queue and domains to skip before topping up.

Get sending settings

Why queued emails are or are not going out.

curl "https://api.rankparse.com/v1/outreach/campaigns/V1StGXR8_Z5jdHi6B-myT" \
  -H "X-API-Key: rp_your_key"

Response

{
  "id": "V1StGXR8_Z5jdHi6B-myT",
  "name": "SaaS blogs, competitor gap Nov 2026",
  "your_domain": "example.com",
  "goal": "Links to the pricing guide",
  "status": "pushed",
  "paused": false,
  "created_at": 1790000000000,
  "site_id": "site_abc123",
  "site_host": "example.com",
  "contacts": {
    "total": 40,
    "awaiting_launch": 2,
    "queued": 12,
    "sending": 0,
    "sent": 24,
    "skipped": 2,
    "replied": 3,
    "bounced": 1
  }
}

Get a campaign

Path parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

Get prospecting context

Get sending settings

Path parameters

Response

Errors

Related