Submit expense claim

Submits a draft or declined expense claim for approval. Nothing is posted until expenseClaim.approve. When the company asks for a receipt (Settings, Expense claims, "Receipt required"), a claim without one is refused with 422 expense_claim_receipt_required (expenseClaim.settings.show shows receipt_required): attach the receipt first, in Cybooks or over REST with expenseClaim.receiptUploadSession.create and .complete (mileage claims never need one). A claim in another status is refused with 422 expense_claim_status_mismatch. Every refusal names its code in error.code and at the start of error.message, and the field in error.fields. Idempotency-Key and If-Match with the latest ETag are required. Requires the expense-claims:action OAuth scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Headers
string
required
length ≤ 191

Required unique key whose request hash and terminal response are stored durably for 24 hours.

string

Required. ETag from the latest representation; a stale value returns 412 precondition_failed. Send this header, not the standard If-Match: some HTTP intermediaries evaluate a standard If-Match themselves and can answer 412 even though the change was applied. Never send both; both with different ETags returns 400 conflicting_precondition_headers.

string
deprecated

Accepted with the same value and meaning as Cybooks-If-Match, but do not send it: an intermediary can answer 412 to it after the change was applied. Send Cybooks-If-Match instead.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*