> ## Documentation Index > Fetch the complete documentation index at: https://dev.enterprise.moonpay.com/llms.txt > Use this file to discover all available pages before exploring further. # List cards ## OpenAPI ````yaml https://api.sandbox.iron.xyz/spec/2026-10-01 get /cards openapi: 3.1.0 info: description: The Stablecoin Payment Network title: Iron API - Sandbox version: '2026-10-01' 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: Cards service operations name: Cards - 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: /cards: get: tags: - Cards summary: List cards operationId: listCards parameters: - deprecated: false description: Optional sub-partner UUID; lists that sub-partner's cards explode: true in: header name: X-SUB-PARTNER-ID required: false schema: type: string - deprecated: false description: Only this customer's cards explode: false in: query name: customer_id required: false schema: default: null format: uuid type: string - deprecated: false description: Only cards funded by this wallet explode: false in: query name: wallet_id required: false schema: default: null format: uuid type: string - deprecated: false description: Cards in any of these statuses (comma-separated or repeated values) explode: true in: query name: status required: false schema: default: null items: $ref: '#/components/schemas/CardStatus' type: array - deprecated: false explode: false in: query name: tier required: false schema: allOf: - $ref: '#/components/schemas/CardTier' - default: null default: null - deprecated: false explode: false in: query name: customer_type required: false schema: allOf: - $ref: '#/components/schemas/CardCustomerType' - default: null default: null - deprecated: false description: Cards created at or after this time explode: false in: query name: created_after required: false schema: default: null format: date-time type: string - deprecated: false description: Cards created before this time explode: false in: query name: created_before required: false schema: default: null format: date-time type: string - deprecated: false description: >- Order by creation time: "asc" for oldest first, "desc" for newest first (default) explode: false in: query name: sort_order required: false schema: allOf: - $ref: '#/components/schemas/SortOrder' - default: null default: null - deprecated: false description: 'Paging: the requested page size (max 100)' explode: false in: query name: page_size required: false schema: default: 10 format: uint32 maximum: 100 minimum: 1 type: integer - deprecated: false description: 'Paging: the cursor field from the previous page' explode: false in: query name: cursor required: false schema: default: null format: uuid type: string - $ref: '#/components/parameters/XApiVersion' responses: '200': content: application/json; charset=utf-8: schema: $ref: '#/components/schemas/PagedList_Card' description: '' components: schemas: CardStatus: enum: - active - frozen - revoked - pending_fulfillment - pending_activation type: string CardTier: enum: - standard - premium type: string CardCustomerType: enum: - consumer - business type: string SortOrder: enum: - asc - desc type: string PagedList_Card: 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 type: string items: description: The list of items items: $ref: '#/components/schemas/Card' type: array prev_cursor: default: null description: The cursor used to fetch the previous page type: string required: - items title: PagedList_Card type: object Card: properties: created_at: format: date-time type: string currencies: $ref: '#/components/schemas/CardCurrencies' customer_id: description: The customer the card belongs to format: uuid type: string customer_type: $ref: '#/components/schemas/CardCustomerType' exp_month: type: string exp_year: type: string form_factor: $ref: '#/components/schemas/CardFormFactor' id: format: uuid type: string last_four: type: string status: $ref: '#/components/schemas/CardStatus' tier: $ref: '#/components/schemas/CardTier' updated_at: format: date-time type: string wallet_id: description: The wallet that funds the card format: uuid type: string required: - id - customer_id - wallet_id - form_factor - tier - customer_type - currencies - status - last_four - exp_month - exp_year - created_at - updated_at title: Card type: object CardCurrencies: description: The currency combination a card settles in. enum: - USD - USD_ARS type: string CardFormFactor: enum: - virtual - physical 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, 2026-08-01, 2026-10-01, 2026-10-15. in: header name: X-API-Version required: false schema: type: string x-default: '2026-10-01' ````