> ## Documentation Index > Fetch the complete documentation index at: https://developer.meow.com/llms.txt > Use this file to discover all available pages before exploring further. # List Cards > Returns the cards you have access to. As an admin or viewer you see all entity cards; as a card manager you see your team's cards; as a card user you see only your own. ## OpenAPI ````yaml GET /cards openapi: 3.1.0 info: title: Meow API description: > ## Overview The Meow API provides financial services and billing capabilities for your business. ### Core Features - **Financial data access**: access account information, transactions, balances, and payment networks. - **Crypto operations**: create and manage crypto contacts, and initiate USDC transfers across blockchain networks. ### Billing API The Billing API lets you create and manage invoices and collect payments: - **Product management**: create and manage products with custom pricing. - **Customer management**: maintain invoicing customers with their addresses. - **Invoice creation**: generate invoices with line items, discounts, and custom notes. - **Payment options**: accept payments via ACH, wire, international wire, card, and USDC. - **Collection accounts**: configure accounts for payment collection. ### Getting Started Authenticate by sending your API key in the `x-api-key` request header. To scope requests to a specific entity, include the `x-entity-id` header. Use the `/api-keys/accessible-entities` endpoint to list all entities accessible by your API key. ### Error Responses Errors return JSON with `code`, `message`, and `debug_message`. The `code` aligns with FDX where possible; use `debug_message` for troubleshooting only. Common error codes: - `500`: Internal server error - `501`: Subsystem unavailable - `503`: Scheduled maintenance - `601`: Data not found - `602`: Customer not authorized - `701`: Account not found - `703`: Invalid input (including invalid date ranges) - `704`: Account type not supported - `705`: Account is closed - `801`: Transaction not found contact: name: Meow url: https://meow.com/ email: support@meow.com version: 1.0.0 license: name: Proprietary url: https://www.meow.com/terms-of-service servers: - url: https://api.meow.com/v1 description: Meow API Production - url: https://api.sandbox.meow.com/v1 description: Meow API Sandbox security: - apiKeyAuth: [] tags: - name: API Keys description: Retrieve metadata about API keys and their accessible entities. - name: Accounts description: Access and manage accounts. - name: Approvals - name: Balances description: Retrieve account balances and available funds. - name: Bills description: View and manage bills for vendor payments. - name: Cards description: Manage virtual and physical cards, and view transactions and insights. - name: Collection Accounts description: Manage accounts for payment collection. - name: Contacts description: Manage contacts for crypto and USDC transfers. - name: Customers description: Manage invoicing customers and their details. - name: Entities - name: Invoices description: Create and manage invoices. - name: Limits - name: Line Items description: Manage invoice line items. - name: Partner Onboarding description: Onboard entities using your partner API key. - name: Partner Webhooks - name: Payment Methods description: View available payment method types. - name: Payment Networks description: Manage payment networks and routing information. - name: Products description: Manage products and pricing for invoicing. - name: Routing Numbers description: Validate routing numbers and retrieve bank information. - name: Security Policies - name: Simulations description: >- Trigger simulated events — inbound transfers, card authorizations, application approval — to test integrations end-to-end without real money movement. **Not available in production**: these endpoints exist only in sandbox and development environments and return `404 Not Found` in production. - name: Tax Forms description: Retrieve IRS tax forms (1099 family) issued for accounts. - name: Transactions description: Retrieve account transaction history and details. - name: Transfers description: >- Initiate ACH, wire, book, and crypto transfers, and retrieve transfer details. - name: Webhooks description: Manage webhook subscriptions and inspect delivery history. paths: /cards: get: tags: - Cards summary: List Cards description: >- Returns the cards you have access to. As an admin or viewer you see all entity cards; as a card manager you see your team's cards; as a card user you see only your own. operationId: list_cards_cards_get parameters: - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 title: Limit default: 10 - name: offset in: query required: false schema: type: integer maximum: 1000000 minimum: 0 title: Offset default: 0 - name: query in: query required: false schema: anyOf: - type: string - type: 'null' title: Query - name: statuses in: query required: false schema: anyOf: - type: array items: $ref: '#/components/schemas/CardStatus' - type: 'null' title: Statuses - name: card_types in: query required: false schema: type: array items: $ref: '#/components/schemas/CardFormFactor' default: [] title: Card Types - name: from_created_time in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: From Created Time - name: to_created_time in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: To Created Time - $ref: '#/components/parameters/EntityIdHeader' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/MeowPaginatedList_CardResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKeyAuth: - cards:read components: schemas: CardStatus: type: string enum: - pending - active - suspended - closed - failed title: CardStatus x-enum-varnames: - pending - active - suspended - closed - failed CardFormFactor: type: string enum: - physical - virtual title: CardFormFactor x-enum-varnames: - physical - virtual MeowPaginatedList_CardResponse_: properties: items: items: $ref: '#/components/schemas/CardResponse' type: array title: Items total: type: integer title: Total page: $ref: '#/components/schemas/MeowPage' type: object required: - items - total - page title: MeowPaginatedList[CardResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CardResponse: properties: id: type: string format: uuid title: Id description: Unique card identifier. display_name: type: string title: Display Name description: Card name or nickname. last_four: type: string title: Last Four description: Last 4 digits of the card number. status: $ref: '#/components/schemas/CardStatus' description: Card status. platform: $ref: '#/components/schemas/IssuingPlatform' description: The platform that issued this card. is_physical: type: boolean title: Is Physical description: Whether this is a physical card. is_single_use: type: boolean title: Is Single Use description: Whether this is a single-use card. default: false cardholder: $ref: '#/components/schemas/CardCardholder' description: Cardholder info. created_at: type: string format: date-time title: Created At description: Card creation timestamp. expiration: anyOf: - type: string format: date-time - type: 'null' title: Expiration description: Card expiration date. spending_restriction: anyOf: - $ref: '#/components/schemas/CardSpendingRestriction' - type: 'null' description: Merchant spending restrictions. type: object required: - id - display_name - last_four - status - platform - is_physical - cardholder - created_at title: CardResponse MeowPage: properties: limit: type: integer maximum: 200 minimum: 1 title: Limit default: 10 offset: type: integer maximum: 1000000 minimum: 0 title: Offset default: 0 type: object title: MeowPage ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError IssuingPlatform: type: string enum: - stripe - awx title: IssuingPlatform x-enum-varnames: - stripe - awx CardCardholder: properties: name: type: string title: Name description: Cardholder's full name. public_id: anyOf: - type: string format: uuid - type: 'null' title: Public Id description: Cardholder's public user ID. type: object required: - name title: CardCardholder CardSpendingRestriction: properties: type: $ref: '#/components/schemas/MerchantRestrictionType' description: Whether the merchant list is an allowlist or blocklist. merchants: items: type: string type: array title: Merchants description: Merchant names in the restriction list. type: object required: - type - merchants title: CardSpendingRestriction MerchantRestrictionType: type: string enum: - allow - block title: MerchantRestrictionType x-enum-varnames: - allow - block parameters: EntityIdHeader: name: x-entity-id in: header required: false schema: type: string format: uuid description: Optional `entity_id` to scope requests to a specific entity. securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: Your Meow API key, sent in the `x-api-key` header for authentication. x-scopes: - accounts:read - accounts:write - accounts:payment-networks - accounts:transactions - accounts:balances - accounts:statements - accounts:tax-documents - entity:create - transfers:crypto:write - transfers:usdc:write - transfers:ach:write - transfers:wire:write - transfers:book:write - contacts:read - contacts:write - billing:products:read - billing:products:write - billing:customers:read - billing:customers:write - billing:invoices:read - billing:invoices:write - billing:accounts:read - billpay:read - billpay:write - onboarding:read - onboarding:write - cards:read - cards:write - webhooks:read - webhooks:write - partner:onboarding:read - partner:onboarding:write - partner:webhooks:read - partner:webhooks:write - simulations:write - banking:limits:read - banking:limits:write ````