---
title: "Get payment method"
method: GET
path: "/payment-methods/{paymentMethodId}"
tags: ["Payment Methods"]
---

# Get payment method

`GET /payment-methods/{paymentMethodId}`

## Request

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

Returns a payment method by ID.

## Path parameters

- `paymentMethodId` string, required

## Response `200`

The payment method

- object
  - `_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.
- `404`: The payment method was not found.

## Changes

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

[Operation history](https://skmtc.dev/guesty/apis/guesty-open-api/changes/payment-methods/:paymentMethodId/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)