---
title: "Get Partner Cards List"
method: GET
path: "/partner_cards"
tags: ["Cards"]
---

# Get Partner Cards List

`GET /partner_cards`

Retrieve a paginated list of all partner cards for the business. This endpoint allows you to view all issued partner cards with their current status and details.

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `Content-Type` string
- `Authorization` string

## Response `200`

Successful response

- object
  - `data` object[]
    - `card_holder_name` string — Name of the card holder
    - `expiry_date` string — Card expiry date in MM/YY format
    - `card_last4` string — Last 4 digits of the card number
    - `status` 'active' | 'inactive' | 'expired' | 'terminated' — Current status of the card
    - `booking_id` string — Booking reference associated with the card
    - `created_at` string, date-time — Card creation timestamp
    - `updated_at` string, date-time — Card last update timestamp
    - `id` string — Unique card identifier
    - `amount` number — Card amount limit
    - `total_spend` number — Total amount spent on the card
  - `pagination_meta` object
    - `page` number — Current page number
    - `per_page` number — Number of items per page
    - `total_pages` number — Total number of pages
    - `next_page` number — Next page number (null if last page)
    - `prev_page` number — Previous page number (null if first page)
    - `from` number — Starting item number on current page
    - `to` number — Ending item number on current page
    - `total_count` number — Total number of items across all pages

## Other responses

- `403` — Unauthorised
- `500` — Unexpected error

---

[API](https://skmtc.net/mamopay/apis/cards.md) · [All operations](https://skmtc.net/mamopay/apis/cards/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mamopay/cards/versions/9bdabbad57b0/schema)