Expenses
Get Hris Expense Reports For Org
Paginated list of the org's non-draft, non-contractor expense reports with dashboard summary tiles.
POSThttps://api.toku.com/hris/get-hris-expense-reports-for-org
Required scope: expenses:read
curl --request POST \
--url 'https://api.toku.com/hris/get-hris-expense-reports-for-org' \
--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",
"limit": 50,
"offset": 0,
"summaryOnly": true
}'200 response
{
"totalCount": 0,
"reports": [
{
"hrisExpenseReportID": "string",
"roleInOrgID": "string",
"roleInOrgName": "string",
"roleInOrgEmail": "string",
"roleInOrgDepartment": "string",
"name": "string",
"status": "string",
"startDate": "string",
"endDate": "string",
"expensedCurrencyID": "string",
"expensedCurrencyCode": "string",
"expensedCurrencyName": "string",
"totalAmountInExpenseCurrency": "string",
"submittedAt": "string",
"approvedAt": "string",
"rejectedAt": "string",
"paidAt": "string",
"payoutStatus": "string",
"decisionUndoableUntil": "string",
"rejectionReason": "string",
"reviewComment": "string",
"createdAt": "string",
"updatedAt": "string",
"expenseCount": 0,
"categoryNames": [
"string"
],
"primaryExpenseCategoryName": "string",
"hasReceiptlessExpenses": true,
"thirdPartyProvider": "string",
"thirdPartyReportID": "string",
"reimbursementSyncedAt": "string",
"reimbursementSyncError": "string"
}
],
"dashboardSummary": {
"pendingApprovalCount": 0,
"pendingApprovalAmount": "string",
"approvedThisMonthCount": 0,
"reimbursedThisMonthAmount": "string",
"reimbursedThisMonthAmounts": [
{
"currencyCode": "string",
"amount": "string"
}
]
}
}Authorizations
AuthorizationstringheaderrequiredBearer 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
statusstringAvailable options: DRAFT, SUBMITTED, PENDING_INFO, APPROVED, REJECTED, CANCELLED, PROCESSING, PAID
roleInOrgIDstring<uuid>expensedCurrencyIDstring<uuid>hrisExpenseCategoryIDstring<uuid>fromDatestring<date-time>toDatestring<date-time>searchstringNOTE(ck): a .transform() rule is not mirrored here; TGA still enforces it
Allowed: at most 200 characters
limitintegerAllowed: 1 to 500
Default: 50
offsetintegerAllowed: at least 0
Default: 0
summaryOnlybooleanResponse
200Successful response
totalCountnumberrequiredreportsobject[]requiredShow child attributes
hrisExpenseReportIDstringrequiredroleInOrgIDstringrequiredroleInOrgNamestring | nullrequiredroleInOrgEmailstring | nullrequiredroleInOrgDepartmentstring | nullrequirednamestringrequiredstatusstringrequiredstartDatestring | nullrequiredendDatestring | nullrequiredexpensedCurrencyIDstring | nullrequiredexpensedCurrencyCodestring | nullrequiredexpensedCurrencyNamestring | nullrequiredtotalAmountInExpenseCurrencystring | nullrequiredsubmittedAtstring | nullrequiredapprovedAtstring | nullrequiredrejectedAtstring | nullrequiredpaidAtstring | nullrequiredpayoutStatusstring | nullrequireddecisionUndoableUntilstring | nullrequiredrejectionReasonstring | nullrequiredreviewCommentstring | nullrequiredcreatedAtstring | nullrequiredupdatedAtstring | nullrequiredexpenseCountnumberrequiredcategoryNamesstring[]requiredprimaryExpenseCategoryNamestring | nullrequiredhasReceiptlessExpensesbooleanrequiredthirdPartyProviderstring | nullrequiredthirdPartyReportIDstring | nullrequiredreimbursementSyncedAtstring | nullrequiredreimbursementSyncErrorstring | nullrequireddashboardSummaryobjectrequiredShow child attributes
pendingApprovalCountnumberrequiredpendingApprovalAmountstringrequiredapprovedThisMonthCountnumberrequiredreimbursedThisMonthAmountstringrequiredreimbursedThisMonthAmountsobject[]requiredShow child attributes
currencyCodestring | nullrequiredamountstringrequired400Bad request
401Unauthorized
403Forbidden
404Not found
409Conflict
429Response 429
Was this page helpful? Suggest edits