---
title: "Add a transaction receipt"
method: POST
path: "/v3/spend/transactions/{transactionId}/receipts"
tags: ["transactions"]
---

# Add a transaction receipt

`POST /v3/spend/transactions/{transactionId}/receipts`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/spend/transactions/{transactionId}/receipts`
- Auth: none declared

Add a receipt to an existing transaction.

In the request, use the same upload `url` that you used to upload the receipt image. See [Create a transaction upload URL](https://developer.bill.com/reference/createreceiptuploadurl) to learn about creating a transaction image upload URL.

## Path parameters

- `transactionId` string, required: BILL-generated ID or UUID of the transaction

## Headers

- `apiToken` string, nullable: Access token for Spend & Expense API authentication

## Request body

- TransactionReceiptRequestDto: Add a transaction receipt
  - `url` string, required: Uploaded receipt URL

## Response `200`

Add a transaction receipt response

- ReceiptImage[]
  - `url` string, required: Uploaded receipt URL
  - `filename` string, required: Receipt file name
  - `uuid` string, required: BILL-generated UUID for the receipt image

## Other responses

- `4XX`: List of errors.
- `5XX`: List of errors.

## Changes

- **2026-11-03** `54edddceb0a5`: 4 breaking
  - the response's body type changed from `object` to `array` for status `200`
  - removed the required property `filename` from the response with the `200` status
  - removed the required property `url` from the response with the `200` status
  - removed the required property `uuid` from the response with the `200` status

[Operation history](https://skmtc.dev/bill/apis/bill-v3-api/changes/v3/spend/transactions/:transactionId/receipts/post.md)

---

[API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [All operations](https://skmtc.dev/bill/apis/bill-v3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/bill-v3-api/revisions/54edddceb0a5?raw)