GetInvoice

Returns one invoice, debit note or credit note: its header, the accounts it bills with their taxes, and its action log. Use it after GetInvoiceList to read each invoice in full, for example to post it to your accounting system once it is approved. The fields are the ones of the Invoice page.

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

GET /api/v1/GetInvoice?ID=48211
Token: your-token

Parameter	Required	Meaning
ID	Yes	The invoice’s ID, a whole number, as ID in GetInvoiceList. It can be an invoice 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
An invoice, debit note or credit note has that ID.	Not found

Response

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

{
  "Code": 1,
  "Info": "",
  "RetInfo": {
    "ID": 48211,
    "InvNum": "INV-2026-0042",
    "InvDate": "2026-10-05T00:00:00",
    "Type": "I",
    "Status": "Approved",
    "EntID": 1187,
    "EntCode": "EXTRADE",
    "CreditDays": 30,
    "PFCount": 2,
    "TaxExempt": null,
    "Currency": "USD",
    "Total": 2360.00,
    "JobIDs": [31877],
    "DocID": 90412,
    "CreatedBy": "jsmith",
    "CreatedOn": "2026-10-02T08:41:12.5",
    "ApprovedBy": "jsmith",
    "ApprovedOn": "2026-10-05T07:15:03.18",
    "RefInvID": 0,
    "Accounts": [
      {
        "AccID": 772305,
        "Name": "Ocean Freight 40HC",
        "LocalName": null,
        "Code": "OFRT",
        "JobID": 31877,
        "Rate": 2000.0000,
        "Qty": 1.0000,
        "Total": 2000.00,
        "Taxes": [
          { "TaxCode": "VAT", "FinCode": "VAT18", "Rate": 18.00 }
        ],
        "WOID": 205114,
        "IntRemarks": null,
        "ExtRemarks": "Shanghai to Mombasa",
        "Updated": "2026-10-02T08:40:51.27"
      }
    ],
    "Actions": [
      { "LogTime": "2026-10-04T14:02:10.43", "Action": "Proforma Generated", "Data": "...", "UserID": "jsmith" }
    ]
  },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Field	Meaning
ID	The invoice’s ID in TrakIT.
InvNum	The invoice number. A draft has a pro-forma number, such as PF00123-1, until it is approved.
InvDate	The invoice date, as a date and time at midnight.
Type	I for an invoice, D for a debit note, C for a credit note.
Status	Draft, Approved, Finalised, Cancelled or Written Off: see Statuses. An invoice that TrakIT shows as Reversed keeps its Approved or Finalised status here.
EntID, EntCode	The ID and code of the entity billed. See GetEntity.
CreditDays	The number of days the customer has to pay, the invoice’s Credit Period, or null.
PFCount	How many pro-formas have been generated.
TaxExempt	The finance codes of the taxes the invoice is exempt from, separated by commas, or null.
Currency	The invoice’s currency.
Total	The invoice total, taxes included.
JobIDs	The IDs of the jobs the invoice bills: its job, or for an invoice that is not for one job, the jobs of its accounts. See GetJob.
DocID	The ID of the invoice’s PDF among the finance documents, or 0 when it has none.
CreatedBy, CreatedOn	The user ID of who created the invoice, and when, in UTC.
ApprovedBy, ApprovedOn	The user ID of who approved the invoice, and when, in UTC. null until it is approved.
RefInvID	For a credit note raised against an invoice, the ID of that invoice. Otherwise 0.
Accounts	The accounts the invoice bills, in their order on the invoice: see Accounts.
Actions	The invoice’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 invoice’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 invoice’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.
WOID	The ID of the account’s work order, or null. See GetWO.
IntRemarks, ExtRemarks	The internal and external remarks, or null.
Updated	When the account was last changed, in UTC.

Notes

• A draft’s number and date can still change: its date moves to today each time it is opened, and it gets its final number when it is approved.
• Adjustments and the payments received are not part of the response.