---
title: "Mass update invoice status"
method: POST
path: "/invoices/mass-update-status"
tags: ["Admin Sales: Invoices"]
---

# Mass update invoice status

`POST /invoices/mass-update-status`

## Request

- Base URL: `http://localhost:8000/api/admin`
- URL: `http://localhost:8000/api/admin/invoices/mass-update-status`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-admin-api/docs/invoices/mass-update-status/post.ts> (a function with typed inputs; its response is checked against the schema)

Bulk-sets the status of a batch of invoices to pending, paid, or overdue. This is a manual status override — it does not capture or reverse a payment.

## Request body

- object
  - `indices` integer[], required
  - `value` 'pending' | 'paid' | 'overdue', required

## Response `200`

Invoices updated.

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid admin token.
- `403`: Admin role lacks sales.invoices.view.
- `422`: Empty indices, or value not one of pending/paid/overdue.

---

[API](https://skmtc.dev/bagisto/apis/bagisto-admin-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-admin-api/revisions/3198f11be70f?raw)
