Get a campaign

Reads one campaign in full: the campaign as a creator sees it, what still has to be filled in before it can go live, and whether a change is waiting for the team to review it.

GEThttps://api.tryscouty.com/v1/campaigns/{campaignId}

Scopecampaigns:read
Read
MCP toolscouty_get_campaign

Markdown version for your agent

Authorization

Send a Scouty token as a bearer token in the Authorization header. The token needs the campaigns:read scope, or the call answers 403 insufficient_scope. Tokens and scopes

Authorization: Bearer $SCOUTY_TOKEN

Path parameters

Name	Type	Required	Description
`campaignId`	`integer`	Required	The campaign's id, as scouty_list_campaigns reports it.

Errors

A refusal answers { "error": { "code", "message" } }. Branch on code; the message is for a person. Every error and its fix

Status	error.code	Meaning
401 Unauthorized	`missing_token` `invalid_token` `token_revoked` `token_expired` `token_orphaned`	No token, or one that is not recognized, revoked or expired.
403 Forbidden	`insufficient_scope` `wrong_principal`	The token does not carry the scope this capability needs.
404 Not Found	`not_found`	No such route, or no such campaign for this client.
429 Too Many Requests	`rate_limited`	Too many requests this minute. Retry-After says how long is left.

import os import requests token = os.environ["SCOUTY_TOKEN"] response = requests.get( "https://api.tryscouty.com/v1/campaigns/42", headers={"Authorization": f"Bearer {token}"}, ) print(response.json())

{ "campaignId": 42, "brand": "Acme", "title": "Acme Spring launch", "status": "published", "editable": false, "applicationDeadline": "2026-10-31", "fields": { "title": "Acme Spring launch", "overview": "Short videos showing how you use the Acme water bottle on a normal day.", "payLine": "$150 per approved video, paid by Acme", "deliverables": [ "One 30 to 60 second TikTok", "One Instagram Reel" ], "requirements": [ "18 or older", "Based in the US" ], "marketCountryCodes": [ "US" ], "applicationDeadline": "2026-10-31", "activationMode": "manual" }, "missingForPublish": [], "pendingEdit": { "heldForReview": false, "waiting": false }, "contract": { "uploaded": true, "signingRequired": true }, "activation": { "flowPublished": true, "mode": "manual" } }