GetBill

Returns one bill: its header, the jobs and work orders it covers, the accounts allocated to it with their taxes, and its action log. Use it after GetBillList to read each bill in full, for example to post it to your accounting system once it is validated. The fields are the ones of the Bill page. To create a bill, use SaveBill.

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

GET /api/v1/GetBill?ID=109827
Token: your-token

Parameter	Required	Meaning
ID	Yes	The bill’s ID, a whole number, as ID in GetBillList. It can be a bill of any company.

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
A bill has that ID.	Not found

Response

On success, Code is 1 and RetInfo is the bill. RowsAffected and Identity are 0.

{
  "Code": 1,
  "Info": "",
  "RetInfo": {
    "ID": 109827,
    "BillNumber": "INV-2026-0042",
    "BillDate": "2026-10-01",
    "Received": "2026-10-02",
    "Status": "Validated",
    "EntID": 2214,
    "EntCode": "EXSHIP",
    "DueDate": "2026-10-31",
    "TaxDeduct": 0.0,
    "Currency": "USD",
    "Total": 1150.00,
    "Actual": 1150.00,
    "JobIDs": [31877, 31902],
    "WorkOrders": [205114, 205131],
    "AddedBy": "jsmith",
    "AddedOn": "2026-10-02T09:12:44.31",
    "ValidatedBy": "jsmith",
    "ValidatedOn": "2026-10-06T11:03:27.9",
    "Accounts": [
      {
        "AccID": 772318,
        "Name": "Trucking Mombasa to Nairobi",
        "LocalName": null,
        "Code": "TRK",
        "JobID": 31877,
        "Rate": 500.0000,
        "Qty": 2.0000,
        "Total": 1000.00,
        "Taxes": [
          { "TaxCode": "VAT", "FinCode": "VAT15", "Rate": 15.00 }
        ],
        "IntRemarks": null,
        "ExtRemarks": null,
        "Updated": "2026-10-03T10:21:05.6"
      }
    ],
    "Actions": [
      { "LogTime": "2026-10-02T09:12:44.47", "Action": "Bill Created", "Data": "...", "UserID": "jsmith" }
    ]
  },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Field	Meaning
ID	The bill’s ID in TrakIT.
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.
Status	Submitted, Received, Validated, Finalised, Disputed or Rejected: see How a bill moves through TrakIT.
EntID, EntCode	The ID and code of the entity that sent the bill. See GetEntity.
DueDate	The date payment is due, as yyyy-MM-dd, or null.
TaxDeduct	The tax deduction: tax withheld from the supplier’s payment. 0 when there is none.
Currency	The bill’s currency.
Total	The total of the accounts allocated to the bill, taxes included, in the bill’s currency: the Allocated total of the bill’s Amounts.
Actual	The amount the supplier billed, tax included: the Billed total.
JobIDs	The IDs of the jobs of the allocated accounts. See GetJob.
WorkOrders	The IDs of the work orders of those jobs, except cancelled ones. See GetWO.
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.
Accounts	The accounts allocated to the bill, in order: see Accounts.
Actions	The bill’s action log, oldest first: LogTime (UTC), Action, Data and the UserID of who did it.

Accounts

Each entry of Accounts is one line of the bill’s Accounts tab:

Field	Meaning
AccID	The account’s ID.
Name	The account name, followed by the line’s detail.
LocalName	The account’s Local Name, or null.
Code	The account’s Account Code.
JobID	The ID of the account’s job, or 0.
Rate	The amount per unit. It is in the bill’s currency when the account has an amount in that currency; otherwise it is the account’s amount in its job’s currency.
Qty	The quantity.
Total	Qty times Rate, rounded to 2 decimals, before tax.
Taxes	The account’s taxes, each with its TaxCode, its FinCode (finance code) and its Rate in percent. See Country Taxes.
IntRemarks, ExtRemarks	The internal and external remarks, or null.
Updated	When the account was last changed, in UTC.

Notes

• The bill’s sequence number, profit centre, remarks, adjustments and payments are not part of the response. The bill sequence is in GetBillList. GetPaymentsByStatusDate lists payments, and GetTransaction shows the bills each payment pays.