List Marketplace Campaigns

curl -X GET "https://api.affonso.io/v1/marketplace/campaigns?page=1&limit=50&marketplace_id=cmlaunch01prog0001"

{
  "success": true,
  "data": [
    {
      "id": "cmlaunch01camp0001",
      "name": "Launch Review Bounty",
      "reward": {
        "type": "flat_rate",
        "amount": 100,
        "amount_min": null,
        "amount_max": null,
        "currency": "USD"
      },
      "start_date": "2026-10-01T00:00:00.000Z",
      "end_date": null,
      "program": {
        "id": "cmlaunch01prog0001",
        "name": "Acme Analytics",
        "logo_url": "https://cdn.affonso.io/logos/acme-analytics.png",
        "currency": "USD"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1,
    "has_next_page": false,
    "has_prev_page": false
  }
}

GET

marketplace

campaigns

curl -X GET "https://api.affonso.io/v1/marketplace/campaigns?page=1&limit=50&marketplace_id=cmlaunch01prog0001"

{
  "success": true,
  "data": [
    {
      "id": "cmlaunch01camp0001",
      "name": "Launch Review Bounty",
      "reward": {
        "type": "flat_rate",
        "amount": 100,
        "amount_min": null,
        "amount_max": null,
        "currency": "USD"
      },
      "start_date": "2026-10-01T00:00:00.000Z",
      "end_date": null,
      "program": {
        "id": "cmlaunch01prog0001",
        "name": "Acme Analytics",
        "logo_url": "https://cdn.affonso.io/logos/acme-analytics.png",
        "currency": "USD"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1,
    "has_next_page": false,
    "has_prev_page": false
  }
}

List live marketplace campaign teasers, ordered by start_date descending. This endpoint is public and does not require authentication. The Authorization header is ignored, including leftover or invalid API keys.

The team routes under /v1/program/campaigns, List Campaigns and Get Campaign, require an API key with read:program. They return only your team’s campaigns in any status, including drafts, with owner fields such as status, max_budget and retainer settings. Marketplace routes show the partner view: only live campaigns from marketplace-listed programs across any team, public teasers without authentication, no max_budget, and hidden owner settings. The full brief (details) is available only for an approved partner of your team through affiliate_id and an API key with read:affiliates.

Query Parameters

integer

default:"1"

Page number for pagination. Minimum 1.

integer

default:"50"

Number of results per page. Minimum 1, maximum 200.

string

Filter by an encoded marketplace program id from List Marketplace Programs or Get Marketplace Program.

Response

Paginated list of campaign teasers. Full briefs are available through Get Marketplace Campaign for eligible partners.

boolean

Always true for successful responses

array

Array of campaign teasers.

Show Campaign Teaser Properties

string

Encoded campaign id

string

Campaign title

object

Campaign reward.

Show Reward Properties

string

flat_rate, custom, range, or retainer

number | null

Fixed reward amount

number | null

Range minimum

number | null

Range maximum

string

Team currency, for example USD

string

ISO 8601 start datetime

string | null

ISO 8601 end datetime, or null

object

Marketplace program.

Show Program Properties

string

Encoded program id, the same as the marketplace program id

string

Program name

string | null

Program logo URL, falling back to the team avatar

string

Program currency, for example USD

object

Pagination metadata: page (integer), limit (integer), total (integer), total_pages (integer), has_next_page (boolean), has_prev_page (boolean).

curl -X GET "https://api.affonso.io/v1/marketplace/campaigns?page=1&limit=50&marketplace_id=cmlaunch01prog0001"

{
  "success": true,
  "data": [
    {
      "id": "cmlaunch01camp0001",
      "name": "Launch Review Bounty",
      "reward": {
        "type": "flat_rate",
        "amount": 100,
        "amount_min": null,
        "amount_max": null,
        "currency": "USD"
      },
      "start_date": "2026-10-01T00:00:00.000Z",
      "end_date": null,
      "program": {
        "id": "cmlaunch01prog0001",
        "name": "Acme Analytics",
        "logo_url": "https://cdn.affonso.io/logos/acme-analytics.png",
        "currency": "USD"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1,
    "has_next_page": false,
    "has_prev_page": false
  }
}

Notes

Only ACTIVE campaigns whose start_date is at or before now and whose end_date is null or at or after now are visible. Their program must have joined the marketplace, be ACTIVE, and have an access mode other than invite.
Public marketplace requests have an IP rate limit of 60 requests per window. Rate limit headers are X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Authenticated requests also have the normal API key rate limit.
Responses use Cache-Control: no-store because campaign windows are time-sensitive.
Only teasers are returned. max_budget is never returned on marketplace routes.
Invalid page or limit values return VALIDATION_ERROR (HTTP 400), with the message “Invalid query parameters” and details.
An invalid marketplace_id returns VALIDATION_ERROR (HTTP 400), with the message “Invalid marketplace program ID” and field marketplace_id.
A server error returns INTERNAL_ERROR (HTTP 500), with the message “Failed to fetch campaigns”.

Getting Started

Guide

Core Resources

Program Management

Marketplace

List Marketplace Campaigns

Query Parameters

Response

Notes

​Query Parameters

​Response

​Notes

Query Parameters

Response

Notes