> ## 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.

# Delete Bill

> Cancels a bill that has not yet been approved. Approved or paid bills cannot be deleted here.



## OpenAPI

````yaml DELETE /bills/{bill_id}
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:
  /bills/{bill_id}:
    delete:
      tags:
        - Bills
      summary: Delete Bill
      description: >-
        Cancels a bill that has not yet been approved. Approved or paid bills
        cannot be deleted here.
      operationId: delete_bill
      parameters:
        - name: bill_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: The bill ID.
            title: Bill Id
          description: The bill ID.
        - $ref: '#/components/parameters/EntityIdHeader'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - apiKeyAuth:
            - billpay: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:
    BillResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Identifier for this bill.
        status:
          $ref: '#/components/schemas/BillStatusEnum'
          description: The current status of the bill.
        vendor_name:
          type: string
          title: Vendor Name
          description: The name of the vendor.
        invoice_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Invoice Number
          description: The invoice number.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Description of the bill.
        memo:
          anyOf:
            - type: string
            - type: 'null'
          title: Memo
          description: Memo for the bill.
        bill_date:
          anyOf:
            - $ref: '#/components/schemas/DateString'
            - type: 'null'
          description: The bill date.
        bill_due_date:
          anyOf:
            - $ref: '#/components/schemas/DateString'
            - type: 'null'
          description: The due date.
        bill_total:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Bill Total
          description: The total amount of the bill.
        currency:
          anyOf:
            - $ref: '#/components/schemas/Iso4217Code'
            - type: 'null'
          description: The bill's currency.
        payment_type:
          anyOf:
            - $ref: '#/components/schemas/BillPaymentTypeEnum'
            - type: 'null'
          description: >-
            How this bill is paid: `ACH`, `WIRE`, `CHECK`, `CRYPTO`, or
            `INTERNATIONAL_PAYMENT_FX`.
        contact_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Contact Id
          description: The ID of the associated contact.
        category_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Category Id
          description: The spend category this bill is coded to, if any.
        category_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Category Name
          description: The name of the spend category, if any.
        creation_source:
          $ref: '#/components/schemas/BillCreationSourceEnum'
          description: How the bill was created.
        created_by:
          type: string
          title: Created By
          description: Who created the bill.
        created_at:
          $ref: '#/components/schemas/Timestamp'
          description: The creation timestamp.
        updated_at:
          anyOf:
            - $ref: '#/components/schemas/Timestamp'
            - type: 'null'
          description: The last-updated timestamp.
        submitted_at:
          anyOf:
            - $ref: '#/components/schemas/Timestamp'
            - type: 'null'
          description: When the bill was submitted for approval.
        submitted_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Submitted By
          description: Who submitted the bill.
        paid_at:
          anyOf:
            - $ref: '#/components/schemas/Timestamp'
            - type: 'null'
          description: The paid timestamp.
        paid_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Paid By
          description: Who paid the bill.
        scheduled_at:
          anyOf:
            - $ref: '#/components/schemas/Timestamp'
            - type: 'null'
          description: The scheduled payment timestamp.
        resolved_at:
          anyOf:
            - $ref: '#/components/schemas/Timestamp'
            - type: 'null'
          description: When the bill was resolved.
        canceled_at:
          anyOf:
            - $ref: '#/components/schemas/Timestamp'
            - type: 'null'
          description: When the bill was canceled.
        canceled_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Canceled By
          description: Who canceled the bill.
        bill_schedule_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Bill Schedule Id
          description: The recurring schedule this bill belongs to, if any.
        ordinal:
          anyOf:
            - type: integer
            - type: 'null'
          title: Ordinal
          description: The bill's position in its recurring schedule (template is 0).
        line_items:
          items:
            $ref: '#/components/schemas/BillLineItemResponse'
          type: array
          title: Line Items
          description: Line items for the bill.
        bill_payment_details:
          anyOf:
            - $ref: '#/components/schemas/BillPaymentDetailsResponse'
            - type: 'null'
          description: >-
            How this bill will be paid once approved: the funding account,
            payment type, currency, and scheduled date.
        additional_documents:
          items:
            $ref: '#/components/schemas/BillDocumentResponse'
          type: array
          title: Additional Documents
          description: Documents attached to the bill, each with a download URL.
        img_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Img Url
          description: A short-lived URL to download the bill's primary document.
        rrule:
          anyOf:
            - type: string
              maxLength: 120
              minLength: 1
              description: >-
                RFC 5545 RRULE string. Required: DTSTART, RRULE. Allowed
                frequencies: WEEKLY, MONTHLY.
            - type: 'null'
          title: Rrule
          description: The recurrence rule, when this bill is part of a schedule.
        auto_approval_enabled:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Auto Approval Enabled
          description: Whether the recurring schedule auto-approves generated bills.
        bill_sync_status:
          anyOf:
            - $ref: '#/components/schemas/IntegrationBillSyncStatus'
            - type: 'null'
          description: Sync status of the bill to your accounting integration.
        payment_sync_status:
          anyOf:
            - $ref: '#/components/schemas/IntegrationBillPaymentSyncStatus'
            - type: 'null'
          description: Sync status of the payment to your accounting integration.
        accounting_vendor:
          anyOf:
            - $ref: '#/components/schemas/IntegrationVendor'
            - type: 'null'
          description: The accounting integration this bill syncs to, if any.
      type: object
      required:
        - id
        - status
        - vendor_name
        - creation_source
        - created_by
        - created_at
      title: BillResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    BillStatusEnum:
      type: string
      enum:
        - CANCELED
        - DRAFT_PROCESSING
        - DRAFT
        - PAYMENT_INFO_NEEDED
        - PENDING
        - APPROVED
        - REJECTED
        - SCHEDULED
        - PAYMENT_INITIATED
        - PAYMENT_DELIVERED
        - PAYMENT_FAILED
        - PAYMENT_CANCELED
      title: BillStatusEnum
      x-enum-varnames:
        - CANCELED
        - DRAFT_PROCESSING
        - DRAFT
        - PAYMENT_INFO_NEEDED
        - PENDING
        - APPROVED
        - REJECTED
        - SCHEDULED
        - PAYMENT_INITIATED
        - PAYMENT_DELIVERED
        - PAYMENT_FAILED
        - PAYMENT_CANCELED
    DateString:
      type: string
      format: date
      title: DateString
      description: >-
        ISO 8601 full-date in the format `YYYY-MM-DD` (per [IETF RFC
        3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
    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
    BillPaymentTypeEnum:
      type: string
      enum:
        - ACH
        - CRYPTO
        - INTERNATIONAL_PAYMENT_FX
        - WIRE
        - CHECK
      title: BillPaymentTypeEnum
      x-enum-varnames:
        - ACH
        - CRYPTO
        - INTERNATIONAL_PAYMENT_FX
        - WIRE
        - CHECK
    BillCreationSourceEnum:
      type: string
      enum:
        - USER
        - EMAIL
        - SCHEDULE
      title: BillCreationSourceEnum
      x-enum-varnames:
        - USER
        - EMAIL
        - SCHEDULE
    Timestamp:
      type: string
      format: date-time
      title: Timestamp
      description: >-
        ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]`
        (per [IETF RFC
        3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
    BillLineItemResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Identifier for this line item.
        amount:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Amount
          description: The unit amount for the line, in the bill's currency.
        quantity:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Quantity
          description: Quantity for an itemized line; omitted for an expense line.
        description:
          type: string
          title: Description
          description: What this line is for.
        type:
          $ref: '#/components/schemas/BillLineItemTypeEnum'
          description: Whether this line is an expense or an itemized quantity.
        amount_total:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Amount Total
          description: >-
            The line total: the unit amount times the quantity for an itemized
            line, or the unit amount for an expense line.
      type: object
      required:
        - id
        - amount
        - description
        - type
        - amount_total
      title: BillLineItemResponse
    BillPaymentDetailsResponse:
      properties:
        account_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Id
          description: >-
            The account this bill will be paid from, in the same id format
            returned by `GET /accounts`.
        payment_type:
          anyOf:
            - $ref: '#/components/schemas/BillPaymentTypeEnum'
            - type: 'null'
          description: >-
            How this bill will be paid: `ACH`, `WIRE`, `CHECK`, `CRYPTO`, or
            `INTERNATIONAL_PAYMENT_FX`.
        currency:
          anyOf:
            - $ref: '#/components/schemas/Iso4217Code'
            - type: 'null'
          description: The currency this bill will be paid in.
        scheduled_payment_date:
          anyOf:
            - $ref: '#/components/schemas/DateString'
            - type: 'null'
          description: The date the payment is scheduled for, if one is set.
      type: object
      title: BillPaymentDetailsResponse
    BillDocumentResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Identifier for this document.
        name:
          type: string
          title: Name
          description: The file name.
        url:
          type: string
          title: Url
          description: A short-lived URL to download the document (expires in 1 hour).
        created_at:
          $ref: '#/components/schemas/Timestamp'
          description: When the document was attached.
      type: object
      required:
        - id
        - name
        - url
        - created_at
      title: BillDocumentResponse
    IntegrationBillSyncStatus:
      type: string
      enum:
        - synced
        - requires_sync
        - sync_complete
        - sync_failed
      title: IntegrationBillSyncStatus
      description: Tracks the sync status of an bill with external accounting systems.
      x-enum-varnames:
        - synced
        - requires_sync
        - sync_complete
        - sync_failed
    IntegrationBillPaymentSyncStatus:
      type: string
      enum:
        - synced
        - requires_sync
        - sync_complete
        - sync_failed
      title: IntegrationBillPaymentSyncStatus
      description: >-
        Tracks the sync status of an bill payment with external accounting
        systems.
      x-enum-varnames:
        - synced
        - requires_sync
        - sync_complete
        - sync_failed
    IntegrationVendor:
      type: string
      enum:
        - QuickBooks
        - Xero
        - NetSuite
        - Puzzle
        - Ramp
        - Stripe
        - Wave
        - Relay
        - Mastercard
      title: IntegrationVendor
    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
    BillLineItemTypeEnum:
      type: string
      enum:
        - EXPENSE
        - ITEM
      title: BillLineItemTypeEnum
      x-enum-varnames:
        - EXPENSE
        - ITEM
  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

````