curl -X GET "https://api.affonso.io/v1/program/campaigns?page=1&limit=50&status=ACTIVE" \
-H "Authorization: Bearer sk_live_your_api_key"
{
"success": true,
"data": [
{
"id": "cmlaunch01camp0001",
"name": "Launch Review Bounty",
"description": null,
"kind": "submission",
"status": "ACTIVE",
"reward_type": "flat_rate",
"reward_amount": 100,
"reward_amount_min": null,
"reward_amount_max": null,
"max_budget": 2000,
"retainer_interval": null,
"retainer_day_of_month": null,
"retainer_weekday": null,
"retainer_schedule_changed_at": null,
"retainer_resumed_at": null,
"start_date": "2026-10-01T00:00:00.000Z",
"end_date": null,
"application_required": true,
"application_prompt": "Link your review draft",
"max_submissions_per_user": null,
"created_at": "2026-09-28T09:00:00.000Z",
"updated_at": "2026-10-01T00:00:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"total_pages": 1,
"has_next_page": false,
"has_prev_page": false
}
}
Campaigns
List Campaigns
List your team’s program campaigns
GET
/
v1
/
program
/
campaigns
curl -X GET "https://api.affonso.io/v1/program/campaigns?page=1&limit=50&status=ACTIVE" \
-H "Authorization: Bearer sk_live_your_api_key"
{
"success": true,
"data": [
{
"id": "cmlaunch01camp0001",
"name": "Launch Review Bounty",
"description": null,
"kind": "submission",
"status": "ACTIVE",
"reward_type": "flat_rate",
"reward_amount": 100,
"reward_amount_min": null,
"reward_amount_max": null,
"max_budget": 2000,
"retainer_interval": null,
"retainer_day_of_month": null,
"retainer_weekday": null,
"retainer_schedule_changed_at": null,
"retainer_resumed_at": null,
"start_date": "2026-10-01T00:00:00.000Z",
"end_date": null,
"application_required": true,
"application_prompt": "Link your review draft",
"max_submissions_per_user": null,
"created_at": "2026-09-28T09:00:00.000Z",
"updated_at": "2026-10-01T00:00:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"total_pages": 1,
"has_next_page": false,
"has_prev_page": false
}
}
List the campaigns owned by your team, newest
start_date first. Requires read:program.
The same data is available through the affonso_list_campaigns MCP tool.
Query Parameters
integer
default:"1"
Page number for pagination. Must be a positive integer.
integer
default:"50"
Number of results per page. Maximum value is 200. Default is 50.
string
Filter by campaign status. Valid values:
DRAFT, SCHEDULED, ACTIVE, ENDED, ARCHIVED.Response
Paginated list of campaigns.boolean
Always
true for successful responsesarray
Array of campaign objects.
Show Campaign Object Properties
Show Campaign Object Properties
string
Encoded campaign id
string
Campaign title
string | null
Campaign description
string
Always
"submission"string
Campaign status. Valid values:
DRAFT, SCHEDULED, ACTIVE, ENDED, ARCHIVED.string
flat_rate, custom, range, or retainernumber | null
Fixed reward amount
number | null
Range minimum
number | null
Range maximum
number | null
Owner-only spend cap. Null means no cap. Always null on retainer.
string | null
monthly or weekly for retainer campaigns, otherwise nullinteger | string | null
1-28 or "last" for monthly retainers, otherwise nullstring | null
Weekday for weekly retainers, otherwise
nullstring | null
ISO 8601 timestamp of the last retainer schedule change, or
nullstring | null
ISO 8601 timestamp set only when a retainer campaign moves from ENDED or ARCHIVED to ACTIVE, or
nullstring
ISO 8601 start datetime
string | null
ISO 8601 end datetime, or
nullboolean
Whether affiliates must apply before submitting proof
string | null
Application question text
integer | null
Per-affiliate submission cap
string
ISO 8601 creation timestamp
string
ISO 8601 update timestamp
object
Pagination metadata:
page, limit, total, total_pages, has_next_page, has_prev_page.curl -X GET "https://api.affonso.io/v1/program/campaigns?page=1&limit=50&status=ACTIVE" \
-H "Authorization: Bearer sk_live_your_api_key"
{
"success": true,
"data": [
{
"id": "cmlaunch01camp0001",
"name": "Launch Review Bounty",
"description": null,
"kind": "submission",
"status": "ACTIVE",
"reward_type": "flat_rate",
"reward_amount": 100,
"reward_amount_min": null,
"reward_amount_max": null,
"max_budget": 2000,
"retainer_interval": null,
"retainer_day_of_month": null,
"retainer_weekday": null,
"retainer_schedule_changed_at": null,
"retainer_resumed_at": null,
"start_date": "2026-10-01T00:00:00.000Z",
"end_date": null,
"application_required": true,
"application_prompt": "Link your review draft",
"max_submissions_per_user": null,
"created_at": "2026-09-28T09:00:00.000Z",
"updated_at": "2026-10-01T00:00:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"total_pages": 1,
"has_next_page": false,
"has_prev_page": false
}
}
Notes
- Requires
read:program. - Campaigns are sorted by
start_datedescending, then by id. - An unknown
statusvalue returnsVALIDATION_ERROR(HTTP 400). - Get a single campaign with Get Campaign.
Was this page helpful?