Get a campaign's plan

Reports the plan covering one campaign: how many creators it may sign this period, how many it has signed and activated, and when the period ends. Amounts and billing links are not part of this answer.

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

Scopeplan:read
Read
MCP toolscouty_get_plan

Markdown version for your agent

Authorization

Send a Scouty token as a bearer token in the Authorization header. The token needs the plan: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 whose plan to read.

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/plan", headers={"Authorization": f"Bearer {token}"}, ) print(response.json())

{ "campaignId": 42, "enforced": true, "status": "active", "tier": "<plan tier>", "tierName": "<plan name>", "interval": "month", "extraSlots": "<integer>", "trialEnd": null, "currentPeriodEnd": "2026-10-15T00:00:00.000Z", "cancelAtPeriodEnd": false, "cap": "<integer>", "used": "<integer>", "remaining": "<integer>", "activated": "<integer>", "activationRemaining": "<integer>", "trial": false, "periodStart": "2026-09-15T00:00:00.000Z", "periodEnd": "2026-10-15T00:00:00.000Z", "full": false }