# List Account Holder Payment Methods

**GET /payment-methods/account-holder/{accountHolderId}**

Returns a paginated list of tokenized payment methods (cards) associated with a specific account holder.

You can specify either an internal account holder ID (assigned by our system) or an external account holder ID (assigned by your system).

The endpoint supports filtering and sorting to help you organize and retrieve payment methods efficiently.



## Servers
- https://api.omni.integratedcommerce.io/v1: https://api.omni.integratedcommerce.io/v1 ()


## Authentication methods
- Api key header


## Parameters

### Path parameters
- **accountHolderId** (string)
  The account holder ID to retrieve payment methods for. Can be either:
  - Internal ID format: `aho_01JRZPRGFF4J2SZC3HMDBYEN2J` (assigned by our system)
  - External ID format: `usr_1757945457790` (assigned by your system)

### Query parameters
- **sorts** (string)
  Comma-separated list of fields to sort by. Prefix with `-` for descending order.
  Available fields: id, type, currency, cardType, maskedCardNumber, cardExpDate, dateCreated
- **page** (integer)
  Page number to retrieve (starts at 1).
  For example, if you have 100 records with 10 per page, page 2 gives you records 11 to 20.
- **pageSize** (integer)
  Number of records per page.
  For example, if you have 100 records with 10 per page, page 2 gives you records 11 to 20.


## Responses
### 200
A successful paginated response containing account holder payment methods

#### Body: application/json (object)
- **totalCount** (integer)
  Total number of payment methods that match the filter criteria
- **page** (integer)
  The current page number (starts at 1)
- **pageSize** (integer)
  Number of items per page
- **totalPages** (integer)
  Total number of pages available
- **hasNextPage** (boolean)
  True if there are more pages of results available
- **hasPreviousPage** (boolean)
  True if there are previous pages of results available
- **items** (array[object])
  List of tokenized payment methods for the account holder

### 401
Unauthorized - Missing or invalid API key

#### Body: application/json (object)
- **code** (integer)

- **status** (string)

- **message** (string)

- **traceId** (string)

- **timestamp** (string(date-time))

- **errorDetails** (array[object])


### 404
Resource not found

#### Body: application/json (object)
- **code** (integer)

- **status** (string)

- **message** (string)

- **traceId** (string)

- **timestamp** (string(date-time))

- **errorDetails** (array[object])



[Powered by Bump.sh](https://bump.sh)