Get a customer's payment methods

Returns a list of payment methods saved to a customer record.

SecurityOAuth2
Request
path Parameters
id
required
string <uuid>

The unique identifier of the customer record.

Example: 8dce2c23-283d-4a2a-8a11-d868a92a42d2
header Parameters
Toast-Restaurant-External-ID
required
string <uuid>

The identifier of the location.

Example: 8dce2c23-283d-4a2a-8a11-d868a92a42d2
Toast-Session-Secret
string

A unique and randomized identifier attached to a payment intent used to retrieve a customer's payment method data.

Example: session-secret
Responses
200

Successful operation. Returns information about a customer's saved payment methods.

401

Your client is not authorized to use the API endpoint.

403

Your client is not authorized to use the API endpoint.

404

The customer record does not exist.

500

Internal server error.

get/v1/customers/{id}/payment-methods
Request samples
curl -i -X GET \
  'https://toast-api-server/v1/customers/{id}/payment-methods' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Toast-Restaurant-External-ID: 8dce2c23-283d-4a2a-8a11-d868a92a42d2' \
  -H 'Toast-Session-Secret: session-secret'
Response samples
application/json
{
  • "results": 2,
  • "paymentMethods": [
    ]
}