Skip to content

GetBills

Lists the bills of the API key’s supplier to the key’s company: the same bills the supplier’s external user sees in the portal, including bills the company entered itself. Use it to follow your bills’ status, due dates and payments. How keys, responses and statuses work is on Vendor bills.

GET /api/public/getbills?FromDate=2026-10-01&ToDate=2026-10-31&Status=Outstanding
APIKey: your-api-key
Parameter Meaning
FromDate, ToDate The range of bill dates, as yyyy-MM-dd, both days included. At most 366 days apart. Required unless BillNumber is given.
BillNumber One bill number. Capitals and spaces do not matter.
Status Only bills with this status: Draft, Submitted, Received, Approved, Rejected, Disputed, or Outstanding for bills with an amount still due.
Page The page to return. The first page is 1, the default.
PageSize Bills per page, from 1 to 500. The default is 100.

Bills come newest bill date first.

RetInfo holds the page and the total number of matching bills, so you can tell how many pages there are:

{
"Code": 1,
"Info": "",
"RetInfo": {
"Page": 1,
"PageSize": 100,
"Total": 2,
"Bills": [
{ "BillID": 109827, "BillNumber": "INV-2026-0042", "Status": "Approved", "...": "..." },
{ "BillID": 109790, "BillNumber": "INV-2026-0038", "Status": "Rejected", "...": "..." }
]
},
"RowsAffected": 2,
"Scalar": null,
"Identity": 0
}

Each entry of Bills is a bill. RowsAffected is the number of bills on this page. A page past the last one returns no bills.

Rule Info when it fails
A date range or a bill number is given. FromDate and ToDate are required (yyyy-MM-dd) unless BillNumber is given
Both dates are given, as yyyy-MM-dd. FromDate and ToDate must both be dates as yyyy-MM-dd
ToDate is not before FromDate. ToDate cannot be earlier than FromDate
The dates are at most 366 days apart. FromDate and ToDate cannot be more than 366 days apart
Status is one of the values above. Status must be one of: ...
PageSize is from 1 to 500. PageSize must be between 1 and 500