Delete an unpaid invoice

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.1099policy.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "1099Policy MCP server": {
    "url": "https://docs.1099policy.com/mcp"
  }
}

DELETE /api/v1/invoices/{invoice}

Permanently deletes an invoice. This cannot be undone. Only an invoice that nothing has been paid, charged or billed against can be deleted. The request fails with a 400, and the invoice is left unchanged, when the invoice:

is paid in full, or has any premium or platform fee payment recorded against it (invoice_already_paid);
has been charged to the contractor's card, including a charge that is still pending (invoice_already_paid);
has been billed on an agency pay invoice (agency_pay_invoice_exists).

A declined charge, or a card check that was never captured, does not prevent deletion.

Path parameters

invoice string Required

The ID of the desired invoice (e.g., in_4RviYgc2Wt).

Responses

200 application/json

A successfully deleted invoice. Otherwise, this call returns an error, such as if the invoice has already been deleted.
Hide response attributes Show response attributes object
- deleted boolean
- deleted_at integer
  
  Unix timestamp (seconds since epoch) of when the invoice was deleted.
- id string
  
  The invoice ID.
- object string
  
  Default value is invoice.
400

The invoice ID is invalid, or the invoice has been paid, charged or billed and cannot be deleted. The response's error_code says which.

DELETE /api/v1/invoices/{invoice}

curl \
 --request DELETE 'https://api.1099policy.com/api/v1/invoices/in_4RviYgc2Wt'

Response examples (200)

{
  "deleted": true,
  "deleted_at": 1640995200,
  "id": "in_4RviYgc2Wt",
  "object": "invoice"
}