SolutionsPricingDocsStart Free
Api

List Referee Offers

GET
/v1/programs/{programId}/referee-offer/versions

List the referee offer versions of a referral Program, newest first. Needs the programs:read key permission.

Authorization

WorkspaceApiKey
X-Api-Key<token>

Workspace-owned Better Auth API key of one environment (Sandbox or Live); it authorizes the Projects of that environment in its Workspace. A Project of the other environment returns 403 ENVIRONMENT_MISMATCH. Never expose it in the browser.

In: header

Path Parameters

programId*string
Match\S
Length1 <= length <= 512

Query Parameters

projectId*string
Length1 <= length <= 128

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/programs/string/referee-offer/versions?projectId=string"
{  "success": true,  "data": [    {      "enabled": true,      "calculation": "percentage",      "rateBps": null,      "amountMinor": "string",      "currency": "string",      "currencyExponent": 0,      "minimumSubtotalMinor": "string",      "validityDays": 1,      "combinesWithProductDiscounts": false,      "combinesWithOrderDiscounts": false,      "combinesWithShippingDiscounts": false,      "changeNote": "string",      "id": "string",      "createdAt": "string",      "updatedAt": "string",      "projectId": "string",      "programId": "string",      "version": 1,      "publishedAt": "string",      "effectiveAt": "string",      "author": "string"    }  ]}