---
title: "Workday Expenses API: Upload Receipts & Submit — Kiweely"
description: "The expense/v1 calls in order: POST /entries, attach a receipt up to 32 MB, POST /reports and /lines, then submit. Plus Expense Items vs Spend Categories."
url: https://kiweely.com/guides/workday-expenses-rest-api-receipt-attachments-expense-lines
---

# Workday Expenses REST API: create a Quick Expense, upload a receipt and submit an Expense Report

Four steps take a receipt to approval: POST /entries for a Quick Expense, POST /entries/{ID}/attachments (32 MB max per file), POST /reports then POST /reports/{ID}/lines, then POST /reports/{ID}/submit to start the Expense Report Event.

-   **Checked** against Workday on November 15
-   Applies to **Workday Expenses API**
-   5 min read
-   Published November 15
-   By Kiweely

Automating mobile receipt capture and expense submission in Workday uses a four-step workflow in the **`expense/v1` REST API** (scoped to the **Expenses** functional area under **`Self-Service: Expense Report`**): stage a **Quick Expense** (`POST /entries`), upload the receipt image or PDF up to `32 MB` (`POST /entries/{ID}/attachments`), create the **Expense Report** header and line referencing that Quick Expense (`POST /reports` -> `POST /reports/{ID}/lines`), and route the report into the **`Expense Report Event`** approval workflow (`POST /reports/{ID}/submit`).

For complex hotel itemizations, per-diem rate tables, mileage calculations, or corporate credit card reconciliations that exceed `expense/v1` REST fields, Workday pairs REST with **`Resource_Management` SOAP** (`Submit_Expense_Report`, `Get_Expense_Reports`, `Get_Expense_Credit_Card_Transactions`) and **WQL** (`expenseReportsForWorker`). Understanding how **Expense Items**, **Spend Categories**, multi-currency conversions, and receipt attachment rules fit together keeps external expense tools from failing accounting validations.

## Comparing Workday Expense APIs Across REST, SOAP, and WQL

| Operation / Resource | Interface | Purpose | Governing Security (`Expenses` Scope) |
| --- | --- | --- | --- |
| `GET /expenseItems` & `/values/bespokePrompt/expenseItem` | REST `expense/v1` | Lists active **Expense Items** segmented for the signed-in worker (`Meals`, `Hotel`, `Ground Transport`). | `Access Expense Item (Segmented)`, `Self-Service: Expense Report` |
| `POST /entries` & `POST /entries/{ID}/attachments` | REST `expense/v1` | Creates a **Quick Expense** (`multipart/form-data`) and attaches receipt files (`32 MB` max per file). | `Self-Service: Expense Report` |
| `POST /reports` & `POST /reports/{ID}/lines` | REST `expense/v1` | Creates a draft **Expense Report** header and attaches lines (direct, or linked from `quickExpense`, `creditCardTransaction`, or `travelBookingRecord`). | `Self-Service: Expense Report` |
| `POST /reports/{ID}/submit` | REST `expense/v1` | Submits the draft report and initiates the `Expense Report Event` business process. | Business Process Type: `Expense Report Event` (Initiate) |
| `Submit_Expense_Report` & `Get_Expense_Reports` | SOAP `Resource_Management` | Full-featured XML expense report creation (itemizations, tax declarations, guest lists, split worktags) and extraction. | `Resource_Management` / `Expense Report Event` BP |
| `expenseReportsForWorker` & `expenseReportLinesForWorker` | WQL (`wql/v1`) | Queries report status, `reimbursementCurrency`, `multicurrencyExpenseEntry`, approval dates, and payment dates. | `Self-Service: Expense Report` (`expenseReportsForCurrentWorker` filter) |

## Expense Items vs. Spend Categories: How Accounting Mapping Works

Engineers coming from general accounting ERPs often search the `expense/v1` OpenAPI specification for a `spendCategory` field on expense lines and come up empty. Workday intentionally separates the **employee-facing prompt** from the **general ledger posting rule**:

1.  **Expense Item (`Create Expense Item`):** What the employee selects (`Taxi / Rideshare`, `Client Dinner`, `Conference Registration`). Each Expense Item defines required instructional attributes (such as `Merchant`, `Attendees`, `Travel City`, or per-mile rate tables) and can be restricted via **Expense Item Security Segments** (`Access Expense Item (Segmented)`) so retail workers do not see executive relocation items.
2.  **Spend Category (`Get_Spend_Category_Hierarchies`):** Mapped behind the scenes on the Expense Item setup (`Setup Considerations: Expense Items`). When the Expense Report reaches approval completion, Workday Accounting derives the **Spend Category** and ledger account from the selected Expense Item plus the header or line `worktag` (`Cost Center`, `Project`, `Region`, `Grant`).
3.  **Prompting Rule:** Always populate your UI dropdown using `GET /expense/v1/values/bespokePrompt/expenseItem` (rather than unfiltered `GET /expenseItems`) so the signed-in worker only sees Expense Items active for their Expense Group and Country.

## End-to-End Receipt Upload and Expense Report Flow (`expense/v1`)

### Step 1: Create a Quick Expense and Upload the Receipt Binary

While you can post bare lines directly to `POST /reports/{ID}/lines`, `expense/v1` attaches receipt binaries specifically on **Quick Expenses** (`POST /entries/{ID}/attachments`). Creating the Quick Expense first mirrors Workday Mobile’s own receipt wallet and carries the attachment cleanly onto the Expense Report line:

http

```
POST /ccx/api/expense/v1/{tenant}/entries HTTP/1.1
Authorization: Bearer <user_delegated_access_credential>
Content-Type: multipart/form-data; boundary=---ExpenseEntryBoundary
```

With the JSON part specifying `date` (the required transaction date), `expenseItem`, `merchant`, `memo`, and `amount` (including transaction currency from `GET /values/bespokePrompt/currency`):

json

```
{
  "date": "2026-11-12",
  "merchant": "Sound Transit Rail",
  "memo": "Airport rail transfer to Seattle client workshop",
  "expenseItem": {
    "id": "dce1c1d299a110000cf4000e5823003c"
  },
  "amount": {
    "value": 3.50,
    "currency": "USD"
  }
}
```

Take the returned Quick Expense `id` and upload the receipt JPEG, PNG, or PDF via `POST /entries/{ID}/attachments` (`32 MB` maximum file size, subject to tenant allowed file extensions and virus scanning in `Edit Tenant Setup - System`; see [Workday attachment upload rules](https://kiweely.com/guides/workday-attachment-upload-virus-scan-size-mime-rules-api)):

json

```
{
  "fileName": "sound-transit-2026-11-12.pdf",
  "contentType": {
    "id": "83509a26446c11de98360015c5e6daf6"
  },
  "fileLength": 84210,
  "attachmentContent": "<base64_encoded_receipt_bytes>"
}
```

### Step 2: Create the Expense Report Header and Line

Create the parent Expense Report via `POST /expense/v1/reports`, passing `creationDate`, `company`, `payee` (the signed-in worker), `expenseReportMemo`, and default costing `worktag`:

json

```
{
  "creationDate": "2026-11-15",
  "company": {
    "id": "7debfd10616e100004ba993bbe7f0039"
  },
  "payee": {
    "id": "3aa5550b7fe348b98d7b5741afc6f534"
  },
  "expenseReportMemo": "Seattle Q4 Client Workshop Travel",
  "worktag": {
    "id": "9dcae422ca6e100009fb17cb0b99004c"
  }
}
```

Then attach your Quick Expense (or an imported corporate card charge `creditCardTransaction`) to the report via `POST /expense/v1/reports/{report_ID}/lines`:

json

```
{
  "date": "2026-11-12",
  "expenseItem": {
    "id": "dce1c1d299a110000cf4000e5823003c"
  },
  "quickExpense": {
    "id": "bace579f29e310000ef5e3b010ac00c7"
  },
  "memo": "Airport rail transfer to Seattle client workshop",
  "totalAmount": {
    "value": 3.50,
    "currency": "USD"
  }
}
```

### Step 3: Multi-Currency Handling and Final Submission

When an employee based in a `USD` company incurs a hotel or rail receipt in `EUR` or `GBP`, capture the **original receipt currency** in `amount` / `totalAmount` (`GET /values/bespokePrompt/currency`). Workday converts the transaction amount into the worker’s `reimbursementCurrency` using the tenant’s active currency rate table (`Maintain Currency Conversion Rates`) as of the expense line’s `date`.

Once all lines and receipts pass policy checks (such as receipt-required thresholds configured on the Expense Item), call `POST /expense/v1/reports/{report_ID}/submit` to launch the **`Expense Report Event`** business process.

## Common Validation Traps to Avoid

-   **Missing Receipt Thresholds:** Many tenants configure a custom or delivered validation requiring an attachment whenever a line exceeds `$25` or `$75`. Submitting `POST /reports/{ID}/submit` without attaching the receipt on the underlying entry triggers an HTTP `400` business process validation failure.
-   **Closed Accounting Periods:** If an employee submits an old receipt dated in a closed financial ledger period, Workday rejects submission unless accounting rules permit posting to the current open period.
-   **Add-Only SOAP Constraint:** In `Resource_Management` SOAP, `Submit_Expense_Report` operates in **Add Only** mode—attempting to re-post the same document ID to edit lines fails with `The Web Service is set to Add Only; documents cannot be resubmitted.` Stage drafts via REST `POST /reports` so users can review every line before triggering `submit`.

Teams building streamlined expense capture or manager approval flows use **[Kiweely Leaf](https://kiweely.com/leaf)** (coming next) to embed fast mobile receipt capture and inline **Teams, Slack, DingTalk, or Lark** expense approvals directly over standard Workday APIs without a Workday Extend license—or **[Kiweely Bridge](https://kiweely.com/bridge)** (coming next) so travelers can check reimbursement status (`expenseReportsForWorker`) or stage expense entries in Claude, ChatGPT, and Gemini with an out-of-band browser confirmation card before submission.

## Frequently asked questions

### Do employees select a Spend Category or an Expense Item when creating an expense line via the Workday API?

Employees and REST callers specify an Expense Item (such as Airfare, Client Meals, or Mileage) retrieved from GET /expense/v1/expenseItems or GET /values/bespokePrompt/expenseItem. Workday automatically derives the underlying accounting Spend Category configured on that Expense Item.

### How do you attach a receipt PDF or photo to an expense line in the Workday expense v1 REST API?

Create a Quick Expense via POST /entries, upload the receipt binary (up to 32 MB) to POST /entries/{ID}/attachments, and then reference that quickExpense ID when adding the line via POST /reports/{ID}/lines so the receipt carries onto the Expense Report.

### Why does Resource\_Management SOAP Submit\_Expense\_Report reject updates to an already submitted report?

In Resource\_Management SOAP, Submit\_Expense\_Report is Add Only for web service submissions—documents cannot be resubmitted to overwrite lines once in progress or posted to a closed ledger period. Use draft staging in REST (POST /reports and POST /reports/{ID}/lines) before calling POST /reports/{ID}/submit.

### Can contingent workers submit Expense Reports via the Workday Expenses API?

Only if your tenant configures contingent worker expense reimbursement or routes contractor spend separately; in Resource\_Management SOAP Submit\_Expense\_Report, Workday enforces the validation that the Expense Payee must be an eligible employee payee unless configured otherwise.

## Sources checked

-   [Steps: Manage Expense Reports](https://doc.workday.com/admin-guide/en-us/financial-management/expenses/managing-expense-reports/prb1493936783777.html)
-   [Setup Considerations: Expense Items](https://doc.workday.com/admin-guide/en-us/financial-management/expenses/expense-items/gcy1595947357695.html)
-   [FAQ: Expense Items](https://doc.workday.com/admin-guide/en-us/financial-management/expenses/expense-items/par1447351934542.html)
-   [Include a Logo and Attachment Page on Expense Report Printouts](https://doc.workday.com/admin-guide/en-us/financial-management/expenses/setting-up-expense-reports/dan1370797727970.html)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### Workday API Attachment Rules: File Size Limits, Allowed MIME Types, and Doctor’s Note Uploads Workday caps API and UI file attachments at 30 MB (10 MB for tenant images), blocks executable extensions such as exe, bat, js, and vbs in Edit Tenant Setup - System, skips automatic virus scanning on web service uploads, and secures medical notes via Document Category Security Segments.](https://kiweely.com/guides/workday-attachment-upload-virus-scan-size-mime-rules-api)
-   [### Authenticating Workday SOAP Web Services with a User-Delegated OAuth Bearer Token Send Workday SOAP requests with an HTTP Authorization Bearer header issued from a user-delegated OAuth 2.0 Authorization Code grant and leave the SOAP XML Header element empty. Workday evaluates both the API Client Functional Area scope and the signed-in worker’s Integration Permissions.](https://kiweely.com/guides/workday-soap-api-bearer-token-user-delegated-oauth)
-   [### Parsing Workday Business Process Custom Validation Errors Returned by REST and SOAP APIs Workday REST APIs return HTTP 400 JSON payloads containing an errors array with code, field, path, and severity (Critical or Warning), whereas Workday SOAP Web Services return HTTP 500 envelopes containing Validation\_Fault (with Xpath) or Processing\_Fault elements.](https://kiweely.com/guides/workday-business-process-validation-errors-rest-soap-responses)
-   [### How to Configure User-Delegated OAuth 2.0 Authorization Code Grant in Workday Register a user-delegated Workday OAuth 2.0 client using Register API Client with Authorization Code Grant, PKCE (S256), and Bearer credentials so external applications authenticate employees through SSO and run under their own Workday permissions.](https://kiweely.com/guides/workday-authorization-code-grant-user-delegated-oauth-setup)

### More guides on Integrations and APIs

[All 89 guides](https://kiweely.com/guides#integrations)

-   [Designing for Workday Tenant API Concurrency and Rate Limits During Peak Employee Traffic](https://kiweely.com/guides/workday-api-rate-limits-concurrency-workforce-self-service)
-   [Calling Workday RaaS Reports with User-Delegated OAuth Instead of an ISU](https://kiweely.com/guides/workday-raas-user-delegated-oauth-vs-isu-basic-auth)
-   [Updating Preferred Name, Pronouns, and Contact Information via the Workday Person API](https://kiweely.com/guides/workday-person-api-legal-preferred-name-contact-updates)
-   [Restricting Workday OAuth Token Use by IP with Maintain IP Ranges](https://kiweely.com/guides/workday-maintain-ip-ranges-manage-authentication-policies-api)
-   [Why Browser Single-Page Apps Hit CORS and Token Limits Against Workday APIs—and How to Fix It](https://kiweely.com/guides/workday-cors-browser-api-calls-why-backend-pass-through-needed)
-   [How Workday Audits Business Processes Initiated via REST or SOAP Web Services](https://kiweely.com/guides/workday-business-process-audit-trail-initiated-via-web-service)
-   [Approving, Denying, and Sending Back Workday Business Process Steps via REST and SOAP APIs](https://kiweely.com/guides/workday-business-process-approve-deny-rest-soap-api)
-   [How Workday Studio PutIntegrationMessage Severity Levels Control Completed-with-Warnings vs. Aborted Runs](https://kiweely.com/guides/workday-studio-error-severity-critical-warning-abort)

### From the blog on Integrations and APIs

[All posts](https://kiweely.com/blog)

-   [Kiweely builds, deploys and runs a Workday Studio integration from one request](https://kiweely.com/blog/workday-studio-integration-built-deployed-and-run)
-   [Why does a Workday EIB load fail, and how do you get a clean load the first time?](https://kiweely.com/blog/why-workday-eib-load-fails)
-   [Kiweely builds and runs a Workday Outbound EIB from one request](https://kiweely.com/blog/workday-outbound-eib-integration-built-and-run)

## Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.
