---
title: "List payment methods"
method: GET
path: "/payment-methods"
tags: ["Payment Methods"]
---

# List payment methods

`GET /payment-methods`

## Request

- Base URL: `https://open-api.guesty.com/v1`
- URL: `https://open-api.guesty.com/v1/payment-methods`
- Auth: API key in header `authorization`

Lists payment methods for a guest or a reservation. Provide exactly one of `guestId` or `reservationId`.

Replaces the deprecated [List a guest's payment methods](https://open-api-docs.guesty.com/reference/guestspaymentmethodlist), and can also list by reservation.

## Query parameters

- `guestId` string
- `reservationId` string

## Response `200`

The payment methods

- object
  - `data` object[], required: Payment methods matching the query
    - `_id` string, required: Guesty payment method id
    - `accountId` string: Guesty account id
    - `guestId` string: Guesty guest id
    - `paymentProviderId` string: Provider used when the card was tokenized
    - `method` string, required: Payment method
    - `payload` object: Provider-specific payload
    - `saveForFutureUse` boolean: Whether this payment method is kept on the guest
    - `reuse` boolean: Whether this payment method can be reused on the guest's other reservations
    - `last4` string: Last four digits of the card, when the method is a card
    - `brand` string: Card brand, when the method is a card
    - `status` 'ACTIVE' | 'INVALID' | 'PENDING_ACTIVATION' | 'INCOMPLETE' | 'CANCELLED' | 'FAILED' | 'DELETED', required: Payment method status
    - `type` 'PHYSICAL' | 'VIRTUAL' | 'ACH': Payment method type
    - `confirmationCode` string: Booking confirmation code sent when the payment method was added (for example `GY-123456`).
    - `createdAt` string, date-time: When the payment method was created. Format: `YYYY-MM-DDTHH:mm:ss.SSSZ`.
    - `updatedAt` string, date-time: When the payment method was last updated. Format: `YYYY-MM-DDTHH:mm:ss.SSSZ`.

## Other responses

- `400`: The request is invalid.
- `401`: Missing or invalid authentication.

## Changes

- **2026-11-03** `3122b8618183`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/guesty/apis/guesty-open-api/changes/payment-methods/get.md)

---

[API](https://skmtc.dev/guesty/apis/guesty-open-api.md) - [All operations](https://skmtc.dev/guesty/apis/guesty-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/guesty/apis/guesty-open-api/revisions/3122b8618183?raw)