List Payment Methods

List all saved payment methods for given entity (scoped down in JWT).

Request

curl -X GET \
  https://api.basistheory.ai/tenants/your-tenant-id/payment-methods \
  -H 'Authorization: Bearer your-api-key'

URL Parameters

Parameter	Required	Type	Default	Description
`tenantId`	true	string	`null`	The tenant ID.

Response

[
  {
    "id": "26859380-7829-4ee1-8a0a-38927881e7ef",
    "type": "card",
    "entityId": "94c94330-94fd-4832-a106-e8474a274fe4",
    "card": {
      "type": "credit",
      "brand": "mastercard",
      "details": {
        "bin": "512035",
        "last4": "4594",
        "expirationMonth": "12",
        "expirationYear": "2025"
      },
      "display": {
        "artUrl": "https://sbx.assets.mastercard.com/card-art/combined-image-asset/6713d73d-a701-4bd2-bc9b-2e98940de9c7.png",
        "backgroundColor": "1A1F71",
        "foregroundColor": "000000",
        "description": "MasterCard Test Bank",
        "issuerName": "Test Issuer"
      }
    },
    "credentialTypes": ["network-token", "virtual-card", "pan"],
    "createdAt": "2025-06-16T14:00:00Z"
  },
  {
    "id": "26859380-7829-4ee1-8a0a-38927881e7ef",
    "type": "card", 
    "entityId": "94c94330-94fd-4832-a106-e8474a274fe4",
    "card": {
      "type": "credit",
      "brand": "visa",
      "details": {
        "bin": "424242",
        "last4": "4242",
        "expirationMonth": "12",
        "expirationYear": "2025"
      },
      "display": {
        "artUrl": "https://sandbox.api.visa.com/image.png",
        "backgroundColor": "1A1F71",
        "foregroundColor": "000000",
        "description": "Visa Test Bank",
        "issuerName": "Test Issuer"
      }
    },
    "credentialTypes": ["network-token", "virtual-card", "pan"],
    "createdAt": "2025-06-16T14:00:00Z"
  }
]

Response Properties

Array of payment method objects:

Property	Type	Description
`id`	string	The payment method ID.
`type`	string	The payment method type.
`entityId`	string	The ID for the entity that owns the payment method.
`card`	Card Object	Specific details for `"card"` payment method `type`.
`credentialTypes`	string[]	Array of available credential types that can be created.
`createdAt`	datetime	The payment method created date.

Card Object

Property	Type	Description
`type`	string	The card type: `debit` or `credit`.
`brand`	string	The card brand (i.e. `visa`, `mastercard`).
`details`	Card Details Object	Details about the card.
`display`	Card Display Object	UI details for displaying the card.

Card Details Object

Property	Type	Description
`bin`	string	6 digit card BIN number.
`last4`	string	Card last 4 numbers.
`expirationMonth`	string	Card expiration month in `MM` format.
`expirationYear`	string	Card expiration year in `YYYY` format.

Card Display Object

Property	Type	Description
`artUrl`	string	A URL for the card art (if available).
`backgroundColor`	string	The background color for rendering the card UI.
`foregroundColor`	string	The foreground color for rendering the card UI.
`description`	string	Short card description.
`issuerName`	string	The card issuer’s name.

Filtering and Pagination

Query Parameters

Parameter	Required	Type	Default	Description
`limit`	false	number	`50`	Maximum number of payment methods to return.
`offset`	false	number	`0`	Number of payment methods to skip.
`type`	false	string	`null`	Filter by payment method type (e.g., `card`).

Example with Pagination

curl -X GET \
  'https://api.basistheory.ai/tenants/your-tenant-id/payment-methods?limit=10&offset=20' \
  -H 'Authorization: Bearer your-api-key'

Error Handling

{
  "error": {
    "status": 401,
    "type": "unauthorized",
    "title": "Unauthorized",
    "message": "Missing or invalid API key was provided."
  }
}