> ## 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 Line Item > Removes one line item from an editable bill. ## OpenAPI ````yaml DELETE /bills/{bill_id}/line-items/{line_item_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. - **Bill pay**: draft bills payable to your vendors and track them through payment. ### Bill Pay API The Bill Pay API lets you create bills for your vendors and track them through payment: - **Bill drafting**: create bills as drafts. Nothing is paid until someone approves the bill in the Meow dashboard. - **Attachments**: upload invoices and supporting documents to a bill. - **Bulk loads**: send an `Idempotency-Key` with every create so a retry never duplicates a bill. Drafting is capped at 500 bills per rolling 24 hours per creator — your entity key, or the user a user-scoped key acts as. Creates past the cap return `429 Too Many Requests`. ### 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. ### Rate Limits Each API key has a limit of 1,200 requests per minute, unless Meow has agreed a different limit with you. The limit works as a token bucket: you can spend the whole minute at once, and requests return steadily over the minute. Responses carry the `RateLimit-Policy` and `RateLimit` headers. They show your limit, the requests you have left, and the seconds until your full limit is back. These headers are informational today: going over the limit is logged, not rejected. A separate, coarser safeguard protects the API from abusive traffic and can reject requests with `429 Too Many Requests`. It returns a `Retry-After` header and a body with `error_code` set to `rate_limited` and a `message`, but not the quota headers above. Wait at least `Retry-After` seconds and add a small random delay. If the retry is limited again, back off exponentially. Send an `Idempotency-Key` when you retry a request that creates something or moves money. ### 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 - url: https://api.dev.meow.com/v1 description: Meow API Development 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: Bill Pay - 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: Feature Access description: >- Request access to restricted features, such as international payments, and track the status of your requests. - 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: Reimbursements description: View reimbursement requests by employee. - 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: Users description: View active users for your entity. - name: Webhooks description: Manage webhook subscriptions and inspect delivery history. - name: Wire Drawdowns description: >- Review vendor requests to draw funds by wire, and pre-authorize trusted vendors. paths: /bills/{bill_id}/line-items/{line_item_id}: delete: tags: - Bills summary: Delete Bill Line Item description: Removes one line item from an editable bill. operationId: delete_bill_line_item parameters: - name: line_item_id in: path required: true schema: type: string format: uuid title: Line Item Id - 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' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' 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. accounting_bill_id: anyOf: - type: string - type: 'null' title: Accounting Bill Id description: The bill's ID in your accounting system, once it has synced there. is_excluded_from_accounting: type: boolean title: Is Excluded From Accounting description: >- Whether this bill was excluded from accounting sync. An excluded bill reports no sync status, same as one that never synced. default: false type: object required: - id - status - vendor_name - creation_source - created_by - created_at title: BillResponse 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. split_group: anyOf: - type: string format: uuid - type: 'null' title: Split Group description: Identifier shared by expense lines that allocate one original line. expense_account_external_id: anyOf: - type: string - type: 'null' title: Expense Account External Id description: >- The expense account this line is mapped to in your accounting system, as set by `POST /bills/{bill_id}/accounting-mappings` or the line's expense-account endpoint. Null when the line is not mapped yet. class_external_id: anyOf: - type: string - type: 'null' title: Class External Id description: >- The QuickBooks Class this line is mapped to, when your accounting settings collect one. Null when Class is off for your entity or the line has none. 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. crypto_destination: anyOf: - $ref: '#/components/schemas/CryptoContactDestinationResponse' - type: 'null' description: >- The vendor crypto address this bill pays, when `payment_type` is `CRYPTO` and a destination has been chosen. ach_transfer_id: anyOf: - type: string - type: 'null' title: Ach Transfer Id description: >- The bank's ID for the ACH transfer that paid this bill, once one has been sent. On a Treasury Prime funding account this is the `ach_...` ID that `GET /accounts/{account_id}/achs/{ach_transfer_id}` accepts; on other banks that endpoint is keyed by transaction group ID, so use this value to reconcile rather than to look the transfer up. wire_transfer_id: anyOf: - type: string - type: 'null' title: Wire Transfer Id description: >- The bank's ID for the wire transfer that paid this bill, once one has been sent. On a Treasury Prime funding account this is the `wire_...` ID that `GET /accounts/{account_id}/wires/{wire_transfer_id}` accepts; on other banks that endpoint is keyed by transaction group ID, so use this value to reconcile rather than to look the transfer up. crypto_transaction_hash: anyOf: - type: string - type: 'null' title: Crypto Transaction Hash description: >- The on-chain transaction that settled this bill, once it has settled. 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 CustomerApiError: oneOf: - $ref: '#/components/schemas/CustomerApiServiceError' - $ref: '#/components/schemas/CustomerApiGatewayError' CustomerApiGatewayError: type: object required: - error_code - message properties: error_code: type: string message: type: string BillLineItemTypeEnum: type: string enum: - EXPENSE - ITEM title: BillLineItemTypeEnum x-enum-varnames: - EXPENSE - ITEM CryptoContactDestinationResponse: properties: id: type: string format: uuid title: Id description: >- Identifier of this crypto address on the contact. Pass it as `crypto_id` to send a crypto transaction here. destination_address: type: string title: Destination Address description: On-chain address funds are sent to, exactly as it was submitted. destination_payment_rail: anyOf: - $ref: '#/components/schemas/ExtBridgePaymentRail' - type: 'null' description: >- The `network` expressed in Bridge's vocabulary. `null` when the network has no Bridge equivalent, in which case this destination cannot be paid over Bridge. destination_currency: anyOf: - $ref: '#/components/schemas/ExtBridgeCryptocurrency' - type: 'null' description: >- The `currency` expressed in Bridge's vocabulary. `null` under the same condition as `destination_payment_rail`. currency: anyOf: - $ref: '#/components/schemas/CryptoCurrency' - type: 'null' description: >- Cryptocurrency to send to this address. `null` only on addresses stored before Meow recorded the currency separately from the Bridge value; read `destination_currency` for those. network: anyOf: - $ref: '#/components/schemas/CryptoNetwork' - type: 'null' description: >- Blockchain network the address lives on. `null` under the same condition as `currency`; read `destination_payment_rail` for those. destination_tag: anyOf: - type: string - type: 'null' title: Destination Tag description: >- Destination tag or memo the receiving exchange needs to credit the funds. When the address is an X-address the tag is read out of it, so this is the tag that will actually be used. `null` for networks and addresses that need no tag. type: object required: - id - destination_address title: CryptoContactDestinationResponse CustomerApiServiceError: type: object required: - code - message - debug_message properties: code: type: integer message: type: string debug_message: type: string ExtBridgePaymentRail: type: string enum: - arbitrum - avalanche_c_chain - base - ethereum - optimism - polygon - solana - stellar - sui - tempo - tron - xdc - ach - ach_push - ach_same_day - fednow - wire title: ExtBridgePaymentRail x-enum-varnames: - arbitrum - avalanche_c_chain - base - ethereum - optimism - polygon - solana - stellar - sui - tempo - tron - xdc - ach - ach_push - ach_same_day - fednow - wire ExtBridgeCryptocurrency: type: string enum: - usdb - usdc - usdt - dai - pyusd - cash - usdg - usdv - eurc - usd - path_usd title: ExtBridgeCryptocurrency x-enum-varnames: - usdb - usdc - usdt - dai - pyusd - cash - usdg - usdv - eurc - usd - path_usd CryptoCurrency: type: string enum: - usdc - usdt - pyusd - cash - usdg - usdv - eurc - eth - sol - btc - xrp - path_usd title: CryptoCurrency x-enum-varnames: - usdc - usdt - pyusd - cash - usdg - usdv - eurc - eth - sol - btc - xrp - path_usd CryptoNetwork: type: string enum: - ethereum - base - solana - arbitrum - polygon - optimism - tron - stellar - avalanche_c_chain - binance - sui - tempo - xdc - bitcoin - ripple title: CryptoNetwork x-enum-varnames: - ethereum - base - solana - arbitrum - polygon - optimism - tron - stellar - avalanche_c_chain - binance - sui - tempo - xdc - bitcoin - ripple responses: BadRequest: description: The request could not be processed. content: application/json: schema: $ref: '#/components/schemas/CustomerApiError' Unauthorized: description: Authentication failed. content: application/json: schema: $ref: '#/components/schemas/CustomerApiGatewayError' Forbidden: description: The API key is not authorized for this operation. content: application/json: schema: $ref: '#/components/schemas/CustomerApiGatewayError' RateLimited: description: Too many requests. headers: Retry-After: schema: type: integer content: application/json: schema: $ref: '#/components/schemas/CustomerApiGatewayError' 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 - transfers:international: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 - reimbursements:read - users:read - webhooks:read - webhooks:write - partner:onboarding:read - partner:onboarding:write - partner:webhooks:read - partner:webhooks:write - simulations:write - banking:limits:read - banking:limits:write - feature-access:read - feature-access:write ````