Expenses

Export Org Expense Backup Report Csv

Builds the org's Expense Backup Report CSV including contractor reimbursement invoices, within admin scope, auditing export.

POSThttps://api.toku.com/hris/export-org-expense-backup-report-csv

Not available to API keys yet. It will need reports:write.

curl --request POST \
  --url 'https://api.toku.com/hris/export-org-expense-backup-report-csv' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "DRAFT",
  "roleInOrgID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "expensedCurrencyID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "hrisExpenseCategoryID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "fromDate": "2026-01-01T00:00:00Z",
  "toDate": "2026-01-01T00:00:00Z",
  "search": "string",
  "summaryOnly": true,
  "includeReimbursementInvoices": true,
  "hrisExpenseReportIDs": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
200 response
{
  "csvData": "string",
  "filename": "string"
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is an access token from a Toku sign-in. See Authentication in the API reference.

Body

application/json

statusstring

Available options: DRAFT, SUBMITTED, PENDING_INFO, APPROVED, REJECTED, CANCELLED, PROCESSING, PAID

roleInOrgIDstring<uuid>
expensedCurrencyIDstring<uuid>
hrisExpenseCategoryIDstring<uuid>
fromDatestring<date-time>
toDatestring<date-time>
searchstring

NOTE(ck): a .transform() rule is not mirrored here; TGA still enforces it

Allowed: at most 200 characters

summaryOnlyboolean
includeReimbursementInvoicesboolean

Default: true

hrisExpenseReportIDsstring<uuid>[]

Allowed: 1 to 500 items

Response

200Successful response
csvDatastringrequired
filenamestringrequired
400Bad request
401Unauthorized
403Forbidden
404Not found
409Conflict
429Response 429
Was this page helpful? Suggest edits