---
title: "Update an Invoice"
method: PATCH
path: "/v2/invoice/{id}"
tags: ["Invoice"]
---

# Update an Invoice

`PATCH /v2/invoice/{id}`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/invoice/{id}`
- Auth: API key in header `Digital-Signature`

Update a single invoice. If the invoice has not yet been paid, you can adjust parameters such as the requested amount, the due datetime and the expiration. If the invoice has already been paid, only the amount can be decreased, which will result in a payment reversal.

## Path parameters

- `id` string, required

## Request body

- object
  - `amount` integer: New amount that should be charged on payment. If the invoice has already been paid, it is the final amount after reversal. Example: 200 (R$2.00).
  - `due` string, date-time: New due datetime. Example: '2020-11-26T17:59:26.000000+00:00'.
  - `expiration` integer: New expiration. Example: 3600 (1 hour).
  - `status` string: This can be used to cancel the invoice by passing 'canceled' as the status patch.

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/starkbank/apis/stark-bank-api.md) - [All operations](https://skmtc.dev/starkbank/apis/stark-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starkbank/apis/stark-bank-api/revisions/aeff5068a5da?raw)