> ## 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. # Create Card > Creates a virtual card scoped to a single merchant and spend limit. Set `single_use` to `true` (default) for a one-shot card that auto-cancels after the first authorization, or `false` for a multi-use card that stays active until expiry or explicit revoke. Retrieve the PAN by calling `POST /cards/{card_id}/pan`. ## OpenAPI ````yaml POST /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: post: tags: - Cards summary: Create Card description: >- Creates a virtual card scoped to a single merchant and spend limit. Set `single_use` to `true` (default) for a one-shot card that auto-cancels after the first authorization, or `false` for a multi-use card that stays active until expiry or explicit revoke. Retrieve the PAN by calling `POST /cards/{card_id}/pan`. operationId: create_card_cards_post parameters: - $ref: '#/components/parameters/EntityIdHeader' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateCardRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CreateCardResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKeyAuth: - cards:write components: 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. schemas: CreateCardRequest: properties: amount: type: integer maximum: 25000 exclusiveMinimum: 0 title: Amount description: Maximum spend limit in whole dollars. currency: $ref: '#/components/schemas/Iso4217Code' description: Three-letter ISO 4217 currency code. default: USD merchant_name: type: string maxLength: 100 minLength: 1 pattern: ^[ -~]+$ title: Merchant Name description: Name of the merchant. nickname: anyOf: - type: string maxLength: 30 minLength: 1 pattern: ^[ -~]+$ - type: 'null' title: Nickname description: >- Display name for the card (max 30 characters). Defaults to the merchant name when omitted. allowed_categories: anyOf: - items: $ref: '#/components/schemas/CardTransactionCategory' type: array - type: 'null' title: Allowed Categories description: Restrict the card to these merchant categories. task_description: type: string title: Task Description description: Brief description of what you are purchasing and why. expires_in_minutes: type: integer maximum: 1440 exclusiveMinimum: 0 title: Expires In Minutes description: Card expires after this many minutes (default 60). default: 60 single_use: type: boolean title: Single Use description: >- If `true`, the card is revoked automatically after the first authorization. If `false`, the card stays usable until expiry or explicit revoke. default: true type: object required: - amount - merchant_name - task_description title: CreateCardRequest CreateCardResponse: properties: payment_type: type: string const: card title: Payment Type default: card controls: $ref: '#/components/schemas/CardControls' metadata: $ref: '#/components/schemas/CardMetadata' type: object required: - controls - metadata title: CreateCardResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Iso4217Code: type: string enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BOV - BRL - BSD - BTN - BWP - BYN - BZD - CAD - CDF - CHE - CHF - CHW - CLF - CLP - CNY - COP - COU - CRC - CUC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - IRR - ISK - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRU - MUR - MVR - MWK - MXN - MXV - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SLE - SEK - SGD - SHP - SLL - SOS - SRD - SSP - STN - SVC - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - USN - UYI - UYU - UYW - UZS - VED - VES - VND - VUV - WST - XAF - XAG - XAU - XBA - XBB - XBC - XBD - XCD - XDR - XOF - XPD - XPF - XPT - XSU - XTS - XUA - XXX - YER - ZAR - ZMW - ZWG - ZWL title: Iso4217Code CardTransactionCategory: type: string enum: - Advertising - Airlines - Books and Newspapers - Car Rental - Charity - Clothing - Electronics - Entertainment - Facilities Expenses - Financial Institutions and Fees - Fuel - Furniture - Government Services - Grocery - Ground Transportation - Insurance - Legal - Lodging - Meals - Medical - Office Supplies - Parking - Political - Professional Services - Recruiting - Rent - Restaurants - Shipping - Software - Taxes - Taxis and Rideshare - Technology Infrastructure - Training and Education - Utilities - Vehicle Expenses title: CardTransactionCategory x-enum-varnames: - advertising - airlines - books_and_newspapers - car_rental - charity - clothing - electronics - entertainment - facilities_expenses - financial_institutions_and_fees - fuel - furniture - government_services - grocery - ground_transportation - insurance - legal - lodging - meals - medical - office_supplies - parking - political - professional_services - recruiting - rent - restaurants - shipping - software - taxes - taxis_and_rideshare - technology_infrastructure - training_and_education - utilities - vehicle_expenses CardControls: properties: spending_limit: type: integer title: Spending Limit description: Maximum spend limit in whole dollars. single_use: type: boolean title: Single Use description: Whether the card is single-use. expires_at: type: string format: date-time title: Expires At description: >- When the card is set to expire. The card is not revoked automatically; revoke it explicitly when you are done with it. type: object required: - spending_limit - single_use - expires_at title: CardControls CardMetadata: properties: card_id: type: string format: uuid title: Card Id description: Identifier for the issued card. task_description: type: string title: Task Description description: What you are purchasing. type: object required: - card_id - task_description title: CardMetadata 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 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 ````