> ## Documentation Index
> Fetch the complete documentation index at: https://walletconnect-pay-docs-docs-webhooks-followups.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List settlements

> List the merchant's configured fiat and crypto settlement destinations.



## OpenAPI

````yaml api/2026-02-19.preview.json GET /v1/merchants/{merchantId}/settlements
openapi: 3.1.0
info:
  title: WalletConnect Pay API
  version: 2026-02-19.preview
servers:
  - url: https://api.pay.walletconnect.com
security:
  - API Key: []
  - ApiKey: []
  - AppId: []
tags:
  - name: Gateway
  - name: Payments
  - name: Refunds
  - name: Merchant Management
  - name: Settlements
  - name: Crypto Settlement
paths:
  /v1/merchants/{merchantId}/settlements:
    get:
      tags:
        - Settlements
      summary: List settlements
      description: List the merchant's configured fiat and crypto settlement destinations.
      operationId: Settlements_list
      parameters:
        - schema:
            type: string
          in: path
          name: merchantId
          required: true
      responses:
        '200':
          description: Settlements list
          content:
            application/json:
              schema:
                type: object
                properties:
                  fiat:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Fiat settlement ID
                          examples:
                            - fiat_Bk4nWp8XmQj2YrTv6
                        status:
                          type: string
                          description: Fiat settlement status
                          examples:
                            - active
                        bankType:
                          type: string
                          description: Bank account type
                          examples:
                            - ACH
                      required:
                        - id
                        - status
                        - bankType
                    description: Fiat settlement configurations attached to the merchant.
                  crypto:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Crypto settlement ID
                          examples:
                            - crypto_Xk7nWp8XmQj2YrTv6
                        asset:
                          type: string
                          description: >-
                            [CAIP-19](https://chainagnostic.org/CAIPs/caip-19)
                            asset identifier
                          examples:
                            - >-
                              eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
                        destination:
                          type: string
                          description: >-
                            [CAIP-10](https://chainagnostic.org/CAIPs/caip-10)
                            destination wallet
                          examples:
                            - >-
                              eip155:8453:0x1234567890abcdef1234567890abcdef12345678
                      required:
                        - id
                        - asset
                        - destination
                    description: Crypto settlement destinations attached to the merchant.
                required:
                  - fiat
                  - crypto
              example:
                fiat:
                  - id: fiat_Bk4nWp8XmQj2YrTv6
                    status: active
                    bankType: ACH
                crypto:
                  - id: crypto_Xk7nWp8XmQj2YrTv6
                    asset: >-
                      eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
                    destination: eip155:8453:0x1234567890abcdef1234567890abcdef12345678
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Human-readable error message
                  code:
                    type: string
                    enum:
                      - missing_api_key
                      - invalid_api_key
                    description: Machine-readable error code
                  details:
                    description: Additional structured error details
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - message
                  - code
              examples:
                missing_api_key:
                  summary: Missing API key
                  value:
                    code: missing_api_key
                    message: Missing API key
                invalid_api_key:
                  summary: Invalid API key
                  value:
                    code: invalid_api_key
                    message: Invalid API key
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Human-readable error message
                  code:
                    type: string
                    const: not_found
                    description: Machine-readable error code
                  details:
                    description: Additional structured error details
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - message
                  - code
              examples:
                not_found:
                  summary: Not Found
                  value:
                    code: not_found
                    message: Not Found
components:
  securitySchemes:
    API Key:
      type: apiKey
      in: header
      name: Api-Key
    ApiKey:
      type: apiKey
      in: header
      name: Api-Key
      description: Private API key for wallet authentication
    AppId:
      type: apiKey
      in: header
      name: App-Id
      description: >-
        Public App ID for wallet authentication. When using this auth mode, the
        Client-Id header is also required.

````