---
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`

<Info>

<Badge color="gray">Documentation in progress</Badge>

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

</Info>

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/revisions/69be73b5cff0/schema)