Get a campaign's Launchpoint payouts

Reads the campaign's Launchpoint program on the brand's own Launchpoint key: the pay held for creators (overdue, due and upcoming), the program's spend, and the Launchpoint wallet's balances. Read only: Launchpoint has no way to pay or approve a payout from outside its dashboard.

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

Scopecreators:read
Read
MCP toolscouty_get_launchpoint_payouts

Markdown version for your agent

Authorization

Send a Scouty token as a bearer token in the Authorization header. The token needs the creators: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 Launchpoint program this is about.

Query parameters

Name	Type	Required	Description
`creatorHandle`	`string`	Optional	Only this creator's pending payouts, by a social handle Launchpoint knows them by.

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
400 Bad Request	`invalid_request`	The request was not the shape this capability takes, or its body was not JSON.
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.

const response = await fetch("https://api.tryscouty.com/v1/campaigns/42/activation/launchpoint/payouts", { headers: { Authorization: `Bearer ${process.env.SCOUTY_TOKEN}`, }, }); console.log(await response.json());

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

{ "campaignId": 42, "program": { "id": "prog_acme_spring", "name": "Acme Spring" }, "pending": { "totalAmount": 450, "overdueCount": 0, "dueCount": 1, "upcomingCount": 2, "payouts": [ { "id": "pay_0001", "creatorId": "cr_0001", "creatorName": "Sample Creator", "contractName": "Acme Spring", "amount": 150, "currency": "usd", "status": "due", "dueDate": "2026-10-20", "deliveredPosts": 3, "requiredPosts": 3, "readyToPay": true } ] }, "spend": { "spend": 1200, "paid": 750, "paidOffPlatform": 0, "awaiting": 150, "tracking": 300 }, "wallet": { "availableBalance": 2000, "pendingBalance": 0, "totalOwed": 450, "lifetimeDeposits": 5000, "lifetimePaidOut": 3000 }, "note": "Amounts are in US dollars. The wallet is your whole Launchpoint workspace's; pending payouts and spend are this campaign's program. Scouty can't pay or approve payouts: that is done in Launchpoint." }