GetBillList

Lists the bills of a date range: bills your suppliers and other entities sent you, with their number, status, amounts and jobs. Use it to pick up the bills that were entered, validated or finalized since your last call, then read each one in full with GetBill. For what each status means, see How a bill moves through TrakIT.

The list holds the bills of one company: the Company of the TrakIT user who signed in (see User fields).

How to sign in and read the response: Authentication, Responses.

GET /api/v1/GetBillList?DateType=Validated&FromDate=2026-10-01&ToDate=2026-10-08
Token: your-token

Parameter	Required	Meaning
`DateType`	Yes	The date the range applies to: `BillDate`, `Added`, `Validated` or `Finalised`. Capitals do not matter. See Date range.
`FromDate`	Yes	The start of the range, as `yyyy-MM-dd`, or `yyyy-MM-ddTHH:mm:ss` for a time. Included.
`ToDate`	Yes	The end of the range, in the same form. Included. At most 365 days after `FromDate`.

Send dates as yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss: other forms depend on the server’s regional settings. See Dates.

Date range

`DateType`	The range applies to
`BillDate`	The bill date, the date printed on the bill.
`Added`	When the bill was entered in TrakIT, in UTC.
`Validated`	When the bill was validated, in UTC. Bills not validated are left out.
`Finalised`	When the bill was finalized, in UTC. Bills not finalized are left out.

Added, Validated and Finalised are times. A date without a time is the start of that day, so ToDate=2026-10-08 stops at midnight at the start of 8 October. To include the whole day, send ToDate=2026-10-08T23:59:59 or the next day.

Rules

Rule	`Info` when it fails
The `Token` header holds a valid token.	`Token missing in header`, `Token invalid or expired`, or another answer listed in Login token
The user is a system administrator with API access.	`API User must be SysAdmin with API Access`
`DateType` has a value.	`DateType is required`
`FromDate` has a value.	`FromDate is required`
`ToDate` has a value.	`ToDate is required`
`DateType` is one of the four values.	`Invalid Date Type. Date Type must be one of the following: BillDate, Added, Validated, Finalised`
`FromDate` is a date.	`FromDate is not valid`
`ToDate` is a date.	`ToDate is not valid`
`ToDate` is not before `FromDate`.	`ToDate must be later than FromDate`
The dates are at most 365 days apart.	`Days between FromDate and ToDate cannot exceed 365`

TrakIT removes spaces from the dates before it reads them, so write a time with the T: 2026-10-08 23:59:59 is refused.

Response

On success, Code is 1, RetInfo is the list, oldest bill date first, and RowsAffected is the number of bills in it. When no bill matches, the list is empty: Code is still 1 and RowsAffected is 0.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "ID": 109827,
      "BillNumber": "INV-2026-0042",
      "BillDate": "2026-10-01",
      "Received": "2026-10-02",
      "DueDate": "2026-10-31",
      "BillSeq": "HQ-2610-0042",
      "Status": "Validated",
      "EntID": 2214,
      "EntCode": "EXSHIP",
      "Currency": "USD",
      "Total": 1150.00,
      "BillActual": 1150.00,
      "TaxDeduct": null,
      "Disputed": false,
      "JobIDs": [31877, 31902],
      "AddedBy": "jsmith",
      "AddedOn": "2026-10-02T09:12:44.31",
      "ValidatedBy": "jsmith",
      "ValidatedOn": "2026-10-06T11:03:27.9"
    }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}

Field	Meaning
`ID`	The bill’s ID in TrakIT. Use it with GetBill.
`BillNumber`	The supplier’s bill number, in capitals and without spaces.
`BillDate`	The bill date, as `yyyy-MM-dd`.
`Received`	The date the bill was received, as `yyyy-MM-dd`.
`DueDate`	The date payment is due, as `yyyy-MM-dd`, or `null`.
`BillSeq`	The bill sequence, the number TrakIT gives the bill when it is validated, or `null` before.
`Status`	`Submitted`, `Received`, `Validated`, `Finalised`, `Disputed` or `Rejected`.
`EntID`, `EntCode`	The ID and code of the entity that sent the bill. See GetEntity.
`Currency`	The bill’s currency.
`Total`	The total of the accounts allocated to the bill, taxes included, in the bill’s currency.
`BillActual`	The amount the supplier billed, tax included.
`TaxDeduct`	The tax deduction: tax withheld from the supplier’s payment, or `null` when there is none.
`Disputed`	`true` when the bill is marked as disputed.
`JobIDs`	The IDs of the jobs of the accounts allocated to the bill. Empty until accounts are allocated. See GetJob.
`AddedBy`, `AddedOn`	The user ID of who entered the bill, and when, in UTC.
`ValidatedBy`, `ValidatedOn`	The user ID of who validated the bill, and when, in UTC. `null` until it is validated.

BillActual and Total are the Billed and Allocated totals of the bill’s Amounts boxes.

Notes

Send every parameter: without one of them the request does not reach the endpoint, and TrakIT answers with HTTP status 404 (see Errors).