---
title: "List program card definition assignments"
method: GET
path: "/v2/loyalties/programs/{programId}/card-definitions"
tags: ["Programs"]
---

# List program card definition assignments

`GET /v2/loyalties/programs/{programId}/card-definitions`

<Warning>

<Badge color="yellow">BETA endpoint</Badge>

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact [Voucherify support](https://www.voucherify.io/contact-support) or your Technical Account Manager.

</Warning>

Returns a cursor-paginated list of card definitions assigned to the program.

## Path parameters

- `id` string, required

## Query parameters

- `limit` union
  - number
  - string
- `order` union
  - string[]
  - '-created_at' | 'created_at'
- `cursor` string, nullable

## Response `200`

Paginated list of card definition assignments.

- ProgramCardDefinitionAssignmentListResponse — Cursor-paginated list of card definition assignments.
  - `object` 'list' — Object type marker.
  - `data` ProgramCardDefinitionAssignment[] — Card definition assignments on the current page.
    - `card_type` 'INDIVIDUAL' — Card type of the assigned card definition.
    - `card_definition_id` string — Unique card definition identifier.
    - `created_at` string, date-time — Assignment creation timestamp (ISO 8601).
    - `object` 'program_card_definition' — Object type marker.
  - `cursor` ProgramListCursor — Cursor for fetching the next page of results. Present only when more results are available.
    - `next` string — Cursor id to pass as the `cursor` query parameter in the next request.
    - `expires_at` string, date-time — Timestamp after which the cursor expires and can no longer be used.

## Other responses

- `400` — Validation error - request body or query parameters failed validation, or the operation is not allowed in the current resource state.
- `404` — Resource not found.
- `409` — Conflict - e.g. duplicate resource or invalid state transition.
- `500` — Internal server error.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-loyalty-v2-api/versions/f6f2f3388362/schema)