API to delete invoice by invoice id
DELETE https://services.leadconnectorhq.com/invoices/{invoiceId}
Authorization
Path parameters
Query parameters
Responses
200 - Successful response
_id (string, required): Invoice Id Example: 6578278e879ad2646715ba9c
status (string, required): Invoice Status Possible values: 'draft', 'sent', 'payment_processing', 'paid', 'void', 'partially_paid' Example: draft
liveMode (boolean, required): Live Mode Example: False
amountPaid (number, required): Amount Paid Example: 0
altId (string, required): Account Id or Agency Id Example: 6578278e879ad2646715ba9c
altType (string, required): Possible values: 'account'
name (string, required): Name of the invoice Example: New Invoice
businessDetails (object, required): Business Details
invoiceNumber (number, required): Invoice Number Example: 19
currency (string, required): Currency Example: USD
contactDetails (object, required): Contact Details
issueDate (string, required): Issue date in YYYY-MM-DD format Example: 2023-01-01
dueDate (string, required): Due date in YYYY-MM-DD format Example: 2023-01-01
discount (object): Discount
invoiceItems (string[], required): Invoice Items
total (number, required): Total Amount Example: 999
title (string, required): Title Example: INVOICE
amountDue (number, required): Total Amount Due Example: 999
createdAt (string, required): created at Example: 2023-12-12T09:27:42.355Z
updatedAt (string, required): updated at Example: 2023-12-12T09:27:42.355Z
automaticTaxesEnabled (boolean): Automatic taxes enabled for the Invoice Example: True
automaticTaxesCalculated (boolean): Is Automatic taxes calculated for the Invoice items Example: True
paymentSchedule (object): split invoice into payment schedule summing up to full invoice amount
{
"_id": "6578278e879ad2646715ba9c",
"status": "draft",
"liveMode": false,
"amountPaid": 0,
"altId": "6578278e879ad2646715ba9c",
"altType": "account",
"name": "New Invoice",
"businessDetails": {
"name": "Alex",
"address": {
"addressLine1": "9931 Beechwood",
"city": "St. Houston",
"state": "TX",
"countryCode": "USA",
"postalCode": "559-6993"
},
"phoneNo": "+1-214-559-6993",
"website": "www.example.com"
},
"invoiceNumber": "19",
"currency": "USD",
"contactDetails": {
"id": "c6tZZU0rJBf30ZXx9Gli",
"phoneNo": "+1-214-559-6993",
"email": "alex@example.com",
"customFields": [],
"name": "Alex",
"address": {
"countryCode": "US"
}
},
"issueDate": "2023-01-01",
"dueDate": "2023-01-01",
"discount": {
"type": "percentage",
"value": 0
},
"invoiceItems": [
// truncado: 20 lineas mas
}
400 - Bad Request
{
"statusCode": 400,
"message": "Unable to find an invoice with the given invoice id"
}
401 - Unauthorized
422 - Unprocessable Entity
Example
curl -X DELETE 'https://services.leadconnectorhq.com/invoices/YOUR_invoiceId' \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Version: 2021-07-28'
const response = await fetch('https://services.leadconnectorhq.com/invoices/YOUR_invoiceId', {
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.LEADWAY_TOKEN}`,
Version: '2021-07-28',
},
});
const data = await response.json();
import os, requests
response = requests.request(
'DELETE',
'https://services.leadconnectorhq.com/invoices/YOUR_invoiceId',
headers={
'Authorization': f"Bearer {os.environ['LEADWAY_TOKEN']}",
'Version': '2021-07-28',
},
)
data = response.json()
<?php
$ch = curl_init('https://services.leadconnectorhq.com/invoices/YOUR_invoiceId');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('LEADWAY_TOKEN'),
'Version: 2021-07-28',
],
]);
$data = json_decode(curl_exec($ch), true);