--- title: "Delete an invoice" method: DELETE path: "/invoices/{invoice_id}" tags: ["Invoices"] --- # Delete an invoice `DELETE /invoices/{invoice_id}` ## Request - Base URL: `https://app-sandbox.resolvepay.com/api` - URL: `https://app-sandbox.resolvepay.com/api/invoices/{invoice_id}` - Auth: one of: - HTTP bearer - HTTP basic - TypeScript: (a function with typed inputs; its response is checked against the schema) Delete an invoice. ## Path parameters - `invoice_id` string, required ## Response `200` An object representing an invoice. - Invoice - `id` string: Unique identifier for the invoice. - `merchant_id` string: ID of the sub-merchant this invoice belongs to. - `source` 'QUICKBOOKS' | 'MERCHANT_USER' | 'ADMIN_USER' | 'CUSTOMER_USER' | 'API' - `customer_id` string: ID of the customer being charged. For marketplace partners, the customer belongs to the partner. For single-merchant partners, the customer belongs to the sub-merchant. - `order_number` string: Order number identifier. - `number` string: Invoice number identifier. - `po_number` string: PO number identifier. - `notes` string: Additional notes for the Customer - `line_items` unknown[]: Line item data - unknown - `merchant_invoice_url` string: The invoice PDF that you've uploaded to Resolve. - `resolve_invoice_url` string: Resolve-issued invoice PDF with your invoice attached. - `resolve_invoice_status` 'not_generated' | 'processing' | 'completed': Shows current status of the Resolve-issued invoice PDF. - `not_generated` - PDF wasn't created or queued for creation. Resolve PDFs are generated when an invoice is sent. - `processing` - PDF is in the process of being generated. Try to refetch the invoice in a minute to get a `resolve_invoice_url` link. - `completed` - PDF is generated, `resolve_invoice_url` points to the generated file. - `fully_paid` boolean: Indicates whether the invoice is fully paid. - `fully_paid_at` string, date-time: The date the invoice has been fully paid. - `advanced` boolean: Indicates whether the invoice has been advanced. - `due_at` string, date-time: The current due date for this invoice's payment. - `original_due_at` string, date-time: The due date for this invoice at the time an advance was issued. - `invoiced_at` string, date-time: The date this invoice was created in your system of record (Resolve or Quickbooks). - `advance_requested` boolean: Indicated if advance was requested. - `terms` 'due_upon_receipt' | 'net7' | 'net10' | 'net10th' | 'net15' | 'net20' | 'net30' | 'net45' | 'net60' | 'net75' | 'net90' | 'net120' | 'net180': The terms selected for this invoice. - `amount_payout_due` number, double: The original amount that Resolve owed on this invoice on the advance date. - `amount_payout_paid` number, double: The amount that Resolve has paid out. - `amount_payout_pending` number, double: The amount that Resolve has currently pending to be paid out. - `amount_payout_refunded` number, double: The amount that Resolve has debited from due to refunds. - `amount_payout_balance` number, double: The amount remaining to be paid out. - `payout_fully_paid` boolean: The status of whether or not this invoice has been fully paid out. - `payout_fully_paid_at` string, date-time: The date of when this invoice has been fully paid out. - `amount_balance` number, double: Current balance due. - `amount_due` number, double: Original amount due. - `amount_refunded` number, double: Amount that has been refunded. - `amount_pending` number, double: Amount of total payments pending. - `amount_paid` number, double: Amount of total payments applied to this invoice. - `amount_advance` number, double: Amount of advance received. - `amount_additional_advance` number, double: Amount of additional advance received. - `amount_advance_fee` number, double: Fee for the amount of advance. - `amount_advance_fee_refund` number, double: Refunded fees for the amount of advance. - `advance_rate` number, double: The advance rate that was used to determine amount of advance. - `advanced_at` string, date-time: The date this invoice was advanced. - `amount_customer_fee_total` number, double: The total amount of customer fees accrued. - `amount_customer_fee_waived` number, double: The total amount of customer fees waived. - `amount_customer_fee_paid` number, double: The total amount of customer fees paid. - `amount_customer_fee_balance` number, double: The current amount of customer fees owed. - `created_at` string, date-time: Date the invoice was created. - `updated_at` string, date-time: Date the invoice was last updated. - `archived` boolean: Boolean indicating if invoice is archived. - `invoice_payment_url` string: Link to make invoice payments. - `canceled` boolean: Indicates whether the invoice is canceled. - `canceled_at` string, date-time: Date the invoice was canceled. - `voided` boolean: Indicates whether the invoice is voided. - `voided_at` string, date-time: Date the invoice was voided. - `amount_canceled` number, double: Amount that has been canceled. - `amount_voided` number, double: Amount that has been voided. - `amount_scheduled` number, double: Amount of scheduled payments. - `status` string: Current payment status of the invoice. - `sent_at` string, date-time: Date the invoice was sent. ## Other responses - `400`: Bad request error - `401`: Unauthorized error - `404`: Not found error - `429`: Rate limit error --- [API](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/revisions/5a1c75b8b404?raw)