---
title: "Batch approve bills"
method: POST
path: "/bills/batch-approve"
tags: ["Bills"]
---

# Batch approve bills

`POST /bills/batch-approve`

Approve multiple bills for payment in a single request.

Bills that cannot be approved will be returned in the `failed` array.

## Request body

- ApproveBillsRequest
  - `billIds` string[], required — Bill IDs to approve

## Response `200`

Batch approval completed

- ApproveBillsResponse
  - `approved` object[]
    - `billId` string, uuid
    - `status` 'AWAITING_INVOICE' | 'IN_REVIEW' | 'APPROVED_TO_PAY' | 'PAID' — Current status of the bill (AP invoice). - `AWAITING_INVOICE`: Waiting for carrier/vendor to submit invoice - `IN_REVIEW`: Invoice received, under review - `APPROVED_TO_PAY`: Approved and ready for payment - `PAID`: Fully paid
  - `failed` object[]
    - `billId` string, uuid
    - `error` string

## Other responses

- `400` — Bad request - invalid input
- `401` — Unauthorized - invalid or missing access token

---

[API](https://skmtc.net/mvmnt/apis/mvmnt-api.md) · [All operations](https://skmtc.net/mvmnt/apis/mvmnt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mvmnt/mvmnt-api/versions/c44e5e7a4256/schema)