Skip to main content

Get All Programs

GET /programs

Get a list of programs available to the supplied API key.

Request Parameters

Header Parameters

NameTypeDescription
program-idstring

Responses

200 Successful Response

ProgramList | application/json

NameTypeProperties
programs requiredarray

items: {'$ref': '#/components/schemas/Program'}

Program | application/json

NameTypeProperties
program_id requiredstring
program_name requiredstring
high_engagement_thresholdinteger

description: This value is the number of actions establishing a user as 'highly engaged' (your best customers) for the purposes of inclusion in the engagement model.

event_relevance_decayinteger

description: This value is the number of days for events to lose half their weight (also called event half-life), implemented as a decay curve over time. This value is used to account for recency relevance so newer actions can carry extra weight in calculations.

        <br/>
action_weight_floornumber

description: This value is the minimum user action recommendation weight required for the action to be included in the final recommendations. Higher numbers bring higher confidence in the recommendations but also limit the number of recommendations provided.

descriptionstring

Response Example

{
"programs": [
{
"program_id": "string",
"program_name": "string",
"high_engagement_threshold": "integer",
"event_relevance_decay": "integer",
"action_weight_floor": "number",
"description": "string"
}
]
}

422 Validation Error

HTTPValidationError | application/json

NameTypeProperties
detailarray

items: {'$ref': '#/components/schemas/ValidationError'}

ValidationError | application/json

NameTypeProperties
loc requiredarray

items: {'anyOf': [{'type': 'string'}, {'type': 'integer'}]}

msg requiredstring
type requiredstring