Skip to main content
GET
/
v2
/
loyalties
/
programs
/
{id}
Get a loyalty program
curl --request GET \
  --url https://api.voucherify.io/v2/loyalties/programs/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'
{
  "id": "<string>",
  "name": "<string>",
  "status": "DRAFT",
  "start_date": "2023-11-07T05:31:56Z",
  "end_date": "2023-11-07T05:31:56Z",
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "object": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
X-App-Id
string
header
required
​
X-App-Token
string
header
required

Path Parameters

​
id
string
required

Unique program identifier

Pattern: ^lprg_[a-f0-9]+$

Response

Program details

Program DTO returned by toDTO()

​
id
string

Unique program identifier

Pattern: ^lprg_[a-f0-9]+$
​
name
string

Program name

​
status
enum<string>
Available options:
DRAFT,
ACTIVE,
INACTIVE,
DELETED
​
start_date
string<date-time> | null

Program start date

​
end_date
string<date-time> | null

Program end date

​
metadata
object

Custom key-value metadata.

​
created_at
string<date-time>

Creation timestamp (ISO 8601)

​
updated_at
string<date-time> | null

Last update timestamp (ISO 8601)

​
object
string
Allowed value: "program"
Last modified on May 11, 2026