Skip to main content
POST
Create expense

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.

Headers

X-Idempotency-Key
string

Body

application/json;charset=UTF-8
receiptDocumentKey
string

Key returned by POST /v1/expenses/upload-url called with shouldAutoCreateExpense=false, once the file has been uploaded. A PDF is attached as-is; JPEG, PNG, HEIC and TIFF files are converted to PDF first.

originalCurrency
string
Example:

"USD"

performedDate
string<date>

Date the expense was incurred; also the date of the exchange rate used when billingAmount is derived

detailedDescription
string | null

Free-text description of the expense as a whole; each line carries its own description

lineItems
object[]

At least one line. The reimbursement category of a line drives the GL account and tax code of the reimbursement.

Response

default - application/json;charset=UTF-8

default response

id
string<uuid>
receiptDocumentKey
string
originalCurrency
string
Example:

"USD"

billingCurrency
string
Example:

"USD"

status
enum<string>

⚠️ This enum is not exhaustive; new values may be added in the future.

Available options:
CREATED,
IN_DRAFT,
SUBMITTED_FOR_REVIEW,
CANCELLED
userId
string<uuid>
companyId
string<uuid>
performedDate
string<date>
detailedDescription
string
lineItems
object[]
createdAt
string<date-time>
updatedAt
string<date-time>