> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iron.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# List open banking payments for an autoramp

> Returns a paginated list of all open banking payment attempts for the
autoramp, ordered by most recent first. Statuses are refreshed from the
provider on every call (skipping payments already in terminal states).

Pagination follows the standard cursor pattern: pass `cursor` =
`iron_payment_id` of the last item in the previous page to fetch the
next (older) page, or `prev_cursor` to walk backward (newer).



## OpenAPI

````yaml /spec.yaml get /autoramps/{autoramp_id}/payments/open-banking
openapi: 3.1.0
info:
  description: The Stablecoin Payment Network
  title: Iron API - Sandbox
  version: 1.0-17138
servers:
  - url: https://api.sandbox.iron.xyz/api
security: []
tags:
  - description: >-
      Wallet and bank account registration


      Every wallet address that interacts with Iron must be registered (linked)
      to a customer **before** it can be used in any flow — onramp, offramp, or
      swap. This is a regulatory requirement under the **Travel Rule**, which
      obliges Virtual Asset Service Providers to exchange originator and
      beneficiary information for crypto transfers.


      Iron supports two wallet types:


      - **Self-hosted wallets** — the customer controls the private key.
      Registration requires a signed proof-of-ownership message.

      - **Hosted wallets** — the wallet is custodied by another VASP (e.g.
      Coinbase, Kraken). Registration requires the VASP's DID so Iron can
      exchange travel-rule data with the custodian.


      Similarly, fiat bank accounts must be registered before they can receive
      offramp payouts.
    name: Addresses
  - description: Operations on Autoramp
    name: Autoramp
  - description: Operations on Chronicle collateral
    name: ChronicleCollateral
  - description: Operations on Currencies
    name: Currencies
  - description: Operations on Customers
    name: Customer
  - description: Operations on Exchange Rate
    name: ExchangeRate
  - description: Operations on Fee Profiles
    name: FeeProfiles
  - description: Operations for Sandbox Testing
    name: Sandbox
  - description: Operations on SSE
    name: Sse
  - description: Operations on Terms and Conditions
    name: TermsAndConditions
  - description: Operations on Webhooks
    name: Webhooks
paths:
  /autoramps/{autoramp_id}/payments/open-banking:
    get:
      tags:
        - Autoramp
      summary: List open banking payments for an autoramp
      description: |-
        Returns a paginated list of all open banking payment attempts for the
        autoramp, ordered by most recent first. Statuses are refreshed from the
        provider on every call (skipping payments already in terminal states).

        Pagination follows the standard cursor pattern: pass `cursor` =
        `iron_payment_id` of the last item in the previous page to fetch the
        next (older) page, or `prev_cursor` to walk backward (newer).
      operationId: listAutorampOpenBankingPayments
      parameters:
        - deprecated: false
          explode: true
          in: path
          name: autoramp_id
          required: true
          schema:
            format: uuid
            type: string
        - deprecated: false
          explode: false
          in: query
          name: cursor
          required: false
          schema:
            default: null
            format: uuid
            type: string
        - deprecated: false
          explode: false
          in: query
          name: prev_cursor
          required: false
          schema:
            default: null
            format: uuid
            type: string
        - deprecated: false
          explode: false
          in: query
          name: page_size
          required: false
          schema:
            default: 10
            format: uint32
            maximum: 10
            type: integer
        - deprecated: false
          explode: false
          in: query
          name: sort_order
          required: false
          schema:
            allOf:
              - $ref: '#/components/schemas/SortOrder'
              - default: null
            default: null
        - $ref: '#/components/parameters/XApiVersion'
      responses:
        '200':
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/PagedList_ApiAutorampOpenBankingPayment'
          description: ''
        '401':
          content:
            application/json; charset=utf-8:
              schema:
                type: string
          description: ''
        '404':
          content:
            application/json; charset=utf-8:
              schema:
                type: string
          description: ''
        '500':
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    SortOrder:
      enum:
        - asc
        - desc
      type: string
    PagedList_ApiAutorampOpenBankingPayment:
      description: |
        PagedList

        A list of items with cursors used to fetch the next or previous page
      properties:
        cursor:
          description: The cursor used to fetch the next page
          format: uuid
          type: string
        items:
          description: The list of items
          items:
            $ref: '#/components/schemas/ApiAutorampOpenBankingPayment'
          type: array
        prev_cursor:
          default: null
          description: The cursor used to fetch the previous page
          format: uuid
          type: string
      required:
        - items
      title: PagedList_ApiAutorampOpenBankingPayment
      type: object
    ApiError:
      description: |-
        Standard error response returned to API clients for server errors.
        Includes a trace_id that clients can reference when reporting issues.
      properties:
        message:
          description: Human-readable error message
          type: string
        trace_id:
          description: Trace ID that can be used to look up request details in logs
          type: string
      required:
        - message
        - trace_id
      title: ApiError
      type: object
    ApiAutorampOpenBankingPayment:
      description: >-
        Autoramp Open Banking Payment with link to initiate flow


        One payment attempt against a provider for an autoramp's open-banking
        flow.
      properties:
        id:
          description: |-
            The provider's payment ID (e.g. tokenio's payment ID). Use this with
            the GET-by-id endpoint to look up the latest status.
          type: string
        iron_payment_id:
          description: |-
            Iron's internal identifier for this open banking payment. Use this
            as the pagination cursor when listing payments.
          format: uuid
          type: string
        payment_link:
          type: string
        settlement_status:
          $ref: '#/components/schemas/ApiAutorampOpenBankingPaymentSettlementStatus'
        status:
          $ref: '#/components/schemas/ApiAutorampOpenBankingPaymentStatus'
      required:
        - id
        - iron_payment_id
        - status
      title: ApiAutorampOpenBankingPayment
      type: object
    ApiAutorampOpenBankingPaymentSettlementStatus:
      enum:
        - InProgress
        - Completed
        - Incomplete
      type: string
    ApiAutorampOpenBankingPaymentStatus:
      description: |
        Autoramp Payment Link Status

        The status of the autoramp payment link
      enum:
        - Pending
        - Ready
        - Processing
        - Completed
        - Failed
      type: string
  parameters:
    XApiVersion:
      description: >-
        Selects the API version for this request, as an ISO date (`YYYY-MM-DD`).
        Omit to use the default version (`2025-03-13`). Supported versions:
        2025-03-13, 2026-07-01.
      in: header
      name: X-API-Version
      required: false
      schema:
        type: string
  securitySchemes:
    ApiKeyAuth:
      description: API Key
      in: header
      name: X-API-Key
      type: apiKey

````