Skip to main content
GET
/
service
/
general-ledger
/
invoices
curl -X GET "https://kube.acho.io/service/general-ledger/invoices?status=Draft&customer_id=a3-customer-xxx&start_date=2024-01-01&end_date=2024-01-31" \
  -H "Authorization: jwt YOUR_TOKEN"

{
  "data": [
    {
      "invoice_id": "INV-2024-001",
      "customer_id": "a3-customer-xxx",
      "customer_name": "Acme Corp",
      "tran_date": "2024-01-15",
      "due_date": "2024-02-15",
      "currency": "USD",
      "status": "Draft",
      "total": 4400,
      "amount_paid": 0,
      "amount_due": 4400,
      "is_overdue": false
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}

​
Request

Retrieve a list of customer invoices with optional filtering.

​
Headers

​
Authorization
string
required
JWT authentication token. Format: jwt YOUR_TOKEN

​
Query Parameters

​
status
string
Filter by status: Draft, Pending Approval, Approved, On Hold, Rejected, Voided, Sent, Partially Paid, Paid, Overdue
​
customer_id
string
Filter by customer ID
​
start_date
string
Filter invoices on or after date (YYYY-MM-DD)
​
end_date
string
Filter invoices on or before date (YYYY-MM-DD)
​
overdue
boolean
Filter to show only overdue invoices
curl -X GET "https://kube.acho.io/service/general-ledger/invoices?status=Draft&customer_id=a3-customer-xxx&start_date=2024-01-01&end_date=2024-01-31" \
  -H "Authorization: jwt YOUR_TOKEN"

{
  "data": [
    {
      "invoice_id": "INV-2024-001",
      "customer_id": "a3-customer-xxx",
      "customer_name": "Acme Corp",
      "tran_date": "2024-01-15",
      "due_date": "2024-02-15",
      "currency": "USD",
      "status": "Draft",
      "total": 4400,
      "amount_paid": 0,
      "amount_due": 4400,
      "is_overdue": false
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}