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

{
  "data": [
    {
      "bill_id": "BILL-2024-001",
      "vendor_id": "a3-vendor-xxx",
      "vendor_name": "Office Supplies Inc",
      "tran_date": "2024-01-15",
      "due_date": "2024-02-15",
      "currency": "USD",
      "status": "Draft",
      "total": 550,
      "amount_paid": 0,
      "amount_due": 550,
      "is_overdue": false
    },
    {
      "bill_id": "BILL-2024-002",
      "vendor_id": "a3-vendor-xxx",
      "vendor_name": "Office Supplies Inc",
      "tran_date": "2024-01-20",
      "due_date": "2024-02-20",
      "currency": "USD",
      "status": "Draft",
      "total": 1200,
      "amount_paid": 0,
      "amount_due": 1200,
      "is_overdue": false
    }
  ],
  "pagination": {
    "total": 2,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}

​
Request

Retrieve a list of vendor bills 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, Partially Paid, Paid, Overdue
​
vendor_id
string
Filter by vendor ID
​
start_date
string
Filter bills with transaction date on or after (YYYY-MM-DD)
​
end_date
string
Filter bills with transaction date on or before (YYYY-MM-DD)
​
overdue
boolean
Filter to show only overdue bills
​
limit
number
default:"20"
Maximum number of records to return (max 100)
​
offset
number
default:"0"
Number of records to skip for pagination
curl -X GET "https://kube.acho.io/service/general-ledger/bills?status=Draft&vendor_id=a3-vendor-xxx&start_date=2024-01-01&end_date=2024-01-31" \
  -H "Authorization: jwt YOUR_TOKEN"

{
  "data": [
    {
      "bill_id": "BILL-2024-001",
      "vendor_id": "a3-vendor-xxx",
      "vendor_name": "Office Supplies Inc",
      "tran_date": "2024-01-15",
      "due_date": "2024-02-15",
      "currency": "USD",
      "status": "Draft",
      "total": 550,
      "amount_paid": 0,
      "amount_due": 550,
      "is_overdue": false
    },
    {
      "bill_id": "BILL-2024-002",
      "vendor_id": "a3-vendor-xxx",
      "vendor_name": "Office Supplies Inc",
      "tran_date": "2024-01-20",
      "due_date": "2024-02-20",
      "currency": "USD",
      "status": "Draft",
      "total": 1200,
      "amount_paid": 0,
      "amount_due": 1200,
      "is_overdue": false
    }
  ],
  "pagination": {
    "total": 2,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}