curl --request GET \
--url https://{your-subdomain}.neetoinvoice.com/api/external/v2/invoices \
--header 'X-Api-Key: <x-api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://{your-subdomain}.neetoinvoice.com/api/external/v2/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetoinvoice.com/api/external/v2/invoices"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"total_count": 1,
"page": 1,
"page_size": 30,
"total_pages": 1,
"next_page": null,
"prev_page": null,
"invoices": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"identifier": "a1b2c3",
"number": "INV-2026-030",
"status": "generated",
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_name": "Acme",
"currency": "USD",
"issue_date": "2026-08-20",
"due_date": "2026-09-04",
"sent_date": "2026-08-20",
"total": 2400,
"grand_total": 2400,
"amount_paid": 0,
"amount_due": 2400,
"days_overdue": 41
}
]
}List invoices
List the workspace’s invoices, newest issue date first, 30 per page by default and up to 100. Deleted invoices are left out.
curl --request GET \
--url https://{your-subdomain}.neetoinvoice.com/api/external/v2/invoices \
--header 'X-Api-Key: <x-api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://{your-subdomain}.neetoinvoice.com/api/external/v2/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetoinvoice.com/api/external/v2/invoices"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"total_count": 1,
"page": 1,
"page_size": 30,
"total_pages": 1,
"next_page": null,
"prev_page": null,
"invoices": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"identifier": "a1b2c3",
"number": "INV-2026-030",
"status": "generated",
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_name": "Acme",
"currency": "USD",
"issue_date": "2026-08-20",
"due_date": "2026-09-04",
"sent_date": "2026-08-20",
"total": 2400,
"grand_total": 2400,
"amount_paid": 0,
"amount_due": 2400,
"days_overdue": 41
}
]
}{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Query Parameters
Only this client's invoices. Accepts the client's identifier or ID. Refer to Getting the Client ID section for detailed instructions.
Only invoices with this status.
generating, generated, paid, written_off, failed, pending_payment Set to true to list only unpaid invoices whose due date is before today.
true, false Only invoices issued on or after this date in YYYY-MM-DD format
Only invoices issued on or before this date in YYYY-MM-DD format
Page of results to retrieve, starting from 1. Defaults to 1 when omitted.
Number of results per page. Defaults to 30 when omitted.
1 <= x <= 100Response
OK - Request succeeded
Total number of records across all pages.
1
Current page number.
1
Number of records per page.
30
Total number of pages.
1
Next page number, or null on the last page.
null
Previous page number, or null on the first page.
null
Hide child attributes
Hide child attributes
"a1b2c3"
"INV-2026-030"
generating, generated, paid, written_off, failed, pending_payment "generated"
"Acme"
"USD"
"2026-08-20"
"2026-09-04"
"2026-08-20"
Total before tax.
2400
Amount billed after discount and tax.
2400
Payments recorded against the invoice.
0
Amount still owed. 0 once the invoice is paid or written off.
2400
Days past the due date while the invoice is unpaid. 0 when not overdue.
41