Skip to main content
GET
Get expense report for organization

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId
string
required

The unique identifier of the organization UUID without dashes (32-character hex string)

Pattern: ^[0-9a-fA-F]{32}$
Example:

"05b8daba9ba14a49846fe77883248cf0"

reportId
string
required

The id of the expense report to retrieve UUID without dashes (32-character hex string)

Pattern: ^[0-9a-fA-F]{32}$

Query Parameters

include
enum<string>[]

Parameter used to include additional data in the response. Available options:

  • expenseRecords: Include all expense records in the report
  • approvalChain: Include approval chain information (reminderSentToApprover, hasRejectedExpenseRecords, hasIncorrectApprovalChains, currentApproverInfo, approvalAllowed)
  • sendChain: Include send chain information (sendChain, hasIncorrectApprovalChains)
  • employeeId: Include the employee ID of the report owner
  • tag: Include tag information (simulatedCardReport, integrationTest, dimensions)
  • externalReports: Include reports an integration module is still working on, under meta.externalReports
  • meta.violations: Include the report's policy violations
  • meta.messages: Include the direct messages attached to the report
  • meta.autoApproval: Include the AI review guidance verdict for the report
  • meta.ids: Include the ids of every report matching the filter, ignoring pagination, under meta.ids
Available options:
expenseRecords,
approvalChain,
sendChain,
employeeId,
tag,
externalReports,
meta.violations,
meta.messages,
meta.autoApproval,
meta.ids

Response

OK

comment
string
dateCreated
string
read-only
emailRecipients
string
expenseRecords
object[]
id
string
lastUpdated
string
name
string
organizationId
string

UUID without dashes (32-character hex string)

Pattern: ^[0-9a-fA-F]{32}$
personId
string

UUID without dashes (32-character hex string)

Pattern: ^[0-9a-fA-F]{32}$
previewUrl
string
read-only
reportNumber
string
sent
string
read-only
paid
string<date-time>
read-only

Date when the expense report was paid. ISO-8601 format (e.g., 2024-01-15T10:30:00Z). Read-only.

approved
string<date-time>
read-only

Date when the expense report was approved. ISO-8601 format (e.g., 2024-01-15T10:30:00Z). Read-only.

status
enum<string>
read-only
Available options:
APPROVAL,
APPROVED,
READY_TO_SEND,
BULK_TRANSFER,
ERROR,
NEW,
NORMAL,
ON_HOLD,
PAID,
REJECTED,
SEND,
SENT,
TRANSFER,
TRANSFER_TO_RECIPIENT,
REVIEW
processStatus
enum<string>
read-only
Available options:
DRAFT,
PROCESSING,
PROCESSED,
REJECTED
reimbursement
number
read-only
reimbursementCurrency
string
read-only
type
enum<string>
read-only
Available options:
AUTOMATIC,
MANUAL,
COMPANY_CARD
ownerName
string
firstName
string

First name of the expense report owner

lastName
string

Last name of the expense report owner

adminErrorInformation
string

Error information from admin operations

organizationName
string
organizationNumber
string
organizationLanguage
string
organizationUseNewDimensions
boolean
organizationRequiresAttestation
boolean
organizationUsesPaymentBasis
boolean
organizationReviewType
enum<string>

Review type for the organization. None, before approval, or after approval. The AFTER_SEND value actually means before approval.

Available options:
NONE,
AFTER_SEND,
AFTER_APPROVAL
expenseRecordCount
integer

Number of expense records in this report

totalAmount
number

Total amount of all expense records in the report

userCanModifyReports
boolean
userCanSendReports
boolean
reportGroup
integer
onHoldStatus
object
read-only

On-hold status information

bank
string

Bank information for payment

dueDate
string<date-time>

Payment due date. ISO-8601 format (e.g., 2024-01-15T10:30:00Z).

cardNumber
string

Card number (masked)

invoiceRef
string

Invoice reference

invoiceNumber
string

Invoice number

invoiceDate
string<date-time>

Invoice date. ISO-8601 format (e.g., 2024-01-15T10:30:00Z).

externalVoucherNumber
string

External voucher number from integration

externalVoucherInformation
string

External voucher information

externalVoucherErrorInformation
string

Error information from external voucher system

externalVoucherId
string

External voucher ID

reminderSentToUser
boolean

Whether a reminder has been sent to the user

employeeId
string

Employee ID (included when 'employeeId' is in include parameter)

reminderSentToApprover
boolean

Whether an approver has been reminded (included when 'approvalChain' is in include parameter)

hasRejectedExpenseRecords
boolean

Whether the report has rejected expense records (included when 'approvalChain' is in include parameter)

hasIncorrectApprovalChains
boolean

Whether the report has incorrect approval chains (included when 'approvalChain' or 'sendChain' is in include parameter)

approvalAllowed
boolean

Whether approval is allowed for this report (included when 'approvalChain' is in include parameter)

currentApproverInfo
object

Information about the current approver (included when 'approvalChain' is in include parameter)

sendChain
object

Send chain information (included when 'sendChain' is in include parameter)

tag
object

Tag information (included when 'tag' is in include parameter)

meta
object

Server-computed metadata for the report. Each property is opt-in through the include parameter.

customFields
object[]
Last modified on August 31, 2026