---
title: "POST /payments/listPaymentInstruments"
method: POST
path: "/payments/listPaymentInstruments"
---

# POST /payments/listPaymentInstruments

`POST /payments/listPaymentInstruments`

List payment instruments for a manager.

## Headers

- `X-Amzn-Bedrock-AgentCore-Payments-User-Id` string
- `X-Amzn-Bedrock-AgentCore-Payments-Agent-Name` string — The agent name associated with the payment request.

## Request body

- object
  - `paymentManagerArn` string, required — The ARN of the payment manager that owns the payment instruments.
  - `paymentConnectorId` string — The ID of the payment connector to filter by.
  - `nextToken` string — Token for pagination to retrieve the next set of results.
  - `maxResults` integer — Maximum number of results to return in a single response.

## Response `200`

Success

- ListPaymentInstrumentsResponse — Response structure for listing payment instruments.
  - `paymentInstruments` PaymentInstrumentSummary[], required — List of payment instrument summaries matching the request criteria.
    - `paymentInstrumentId` string, required — The unique identifier for this payment instrument.
    - `paymentManagerArn` string, required — The ARN of the payment manager that owns this payment instrument.
    - `paymentConnectorId` string, required — The ID of the payment connector associated with this instrument.
    - `userId` string, required — The user ID associated with this payment instrument.
    - `paymentInstrumentType` 'EMBEDDED_CRYPTO_WALLET', required — The type of payment instrument (e.g., EMBEDDED_CRYPTO_WALLET).
    - `status` 'INITIATED' | 'ACTIVE' | 'FAILED' | 'DELETED', required — The current status of this payment instrument.
    - `createdAt` string, date-time, required — The timestamp when this payment instrument was created.
    - `updatedAt` string, date-time, required — The timestamp when this payment instrument was last updated.
  - `nextToken` string — Token for pagination to retrieve the next set of results.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore/versions/79623b33d495/schema)