List Programs
Returns a paginated list of programs, with support for filtering by status, incentive type, currency, and program group.
Last updated: April 9, 2026
List Programs
GET /siren/v1/programs
Returns a paginated list of programs. Results are wrapped by the ListResponseWrapperInterceptor.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
fields | string | — | Comma-separated list of fields to include (required) |
status | string | — | Filter by status |
incentiveType | string | — | Filter by incentive type |
incentiveResolverType | string | — | Filter by incentive resolver type |
units | string | — | Filter by currency unit |
programGroupId | integer | — | Filter to programs belonging to a specific program group |
s | string | — | Search across name and description |
number | integer | 10 | Results per page |
offset | integer | 0 | Pagination offset |
orderBy | string | id | Sort field |
order | string | ASC | Sort direction: ASC or DESC |
Response Headers:
x-siren-estimated-count. Total matching records (exposed viaAccess-Control-Expose-Headers).
Example Request:
GET /siren/v1/programs?fields=id,name,status,collaboratorCount&status=active&number=25
Example Response:
[
{
"id": 1,
"name": "Standard Affiliate Program",
"status": "active",
"collaboratorCount": 12
}
]