Upload, retrieve, and manage vendor bills via the API.
6 min readThe Bills API provides programmatic access to your vendor bill management, including upload, AI scanning, and status tracking.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/bills | List all bills with pagination and filtering. |
| POST | /v1/bills | Upload a new bill (multipart form data). |
| GET | /v1/bills/:id | Retrieve a single bill by ID. |
| PATCH | /v1/bills/:id | Update bill data (correct AI-extracted fields). |
| DELETE | /v1/bills/:id | Delete a bill. |
| POST | /v1/bills/:id/approve | Approve a scanned bill. |
The bill enters a "scanning" status while AI processes the document. Use the GET endpoint or webhooks to check when scanning is complete.
| Status | Description |
|---|---|
| scanning | AI is processing the uploaded document. |
| review | Scanning complete, awaiting human review. |
| approved | Bill data has been verified and approved. |
| paid | Payment has been recorded for this bill. |
© 2026 Saldo. All rights reserved.
Made with care for businesses everywhere
