Skip to main content
GET
/
v1
/
programs
curl -X GET "https://api.affonso.io/v1/programs?limit=10"

{
  "success": true,
  "data": [
    {
      "id": "prog_a1b2c3d4",
      "name": "Acme SaaS",
      "description": "The best project management tool for teams",
      "tagline": "Manage projects effortlessly",
      "category": "SaaS",
      "website_url": "https://acme.com",
      "logo_url": "https://cdn.affonso.io/logos/acme.png",
      "auto_approve": true,
      "currency": "USD",
      "commission": {
        "type": "COMMISSION",
        "value": 30,
        "is_percentage": true,
        "apply_to": "FIRST_PAYMENT",
        "has_multiple_tiers": false
      },
      "terms": {
        "cookie_lifetime_days": 60,
        "payment_frequency": "MONTHLY",
        "payment_threshold": 50
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false
  }
}
This endpoint is public and does not require authentication. It returns all active affiliate programs that have joined the marketplace.

​
Query Parameters

​
page
integer
default:"1"
Page number for pagination. Must be a positive integer.
​
limit
integer
default:"50"
Number of results per page. Minimum 1, maximum 200. Default is 50.
​
category
string
Filter programs by category. Maximum 100 characters.

​
Response

​
success
boolean
Always true for successful responses
​
data
array
Array of marketplace program objects.
​
pagination
object
Pagination metadata object containing:
  • page (integer): Current page number
  • limit (integer): Number of results per page
  • total (integer): Total number of programs matching the filters
  • totalPages (integer): Total number of pages
  • hasNextPage (boolean): Whether there is a next page
  • hasPrevPage (boolean): Whether there is a previous page
curl -X GET "https://api.affonso.io/v1/programs?limit=10"

{
  "success": true,
  "data": [
    {
      "id": "prog_a1b2c3d4",
      "name": "Acme SaaS",
      "description": "The best project management tool for teams",
      "tagline": "Manage projects effortlessly",
      "category": "SaaS",
      "website_url": "https://acme.com",
      "logo_url": "https://cdn.affonso.io/logos/acme.png",
      "auto_approve": true,
      "currency": "USD",
      "commission": {
        "type": "COMMISSION",
        "value": 30,
        "is_percentage": true,
        "apply_to": "FIRST_PAYMENT",
        "has_multiple_tiers": false
      },
      "terms": {
        "cookie_lifetime_days": 60,
        "payment_frequency": "MONTHLY",
        "payment_threshold": 50
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false
  }
}