*REST API › Objects › Finance*

# Supplier invoice

> Invoice received from a supplier.

An invoice received from a supplier, with its internal number and its status. It needs the purchases add-on to validate or void it.

Schemas: `SupplierInvoiceDto`

## Attributes

| Name | Type | Description |
| --- | --- | --- |
| `id` | string | Supplier invoice identifier. |
| `supplierInvoiceNumber` | string | Number the supplier put on the invoice; null if it was not recorded. |
| `status` | string | Status of the invoice within the purchasing cycle. |
| `createdAt` | string<date-time> | Creation date in ISO 8601 UTC. |
| `updatedAt` | string<date-time> | Last modification date in ISO 8601 UTC. |

## Example

*Supplier invoice · Generated from the schema*

```json
{
  "id": "id_8f2a1c",
  "supplierInvoiceNumber": "string",
  "status": "string",
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Returned by

- [`GET /api/v1/supplier-invoices`](https://docs.filmo.io/rest-api/endpoint-reference/supplier-invoices/list-supplier-invoices) — List supplier invoices
- [`GET /api/v1/supplier-invoices/{supplierInvoiceId}`](https://docs.filmo.io/rest-api/endpoint-reference/supplier-invoices/get-a-supplier-invoice) — Get a supplier invoice

## Modified by

- [`POST /api/v1/supplier-invoices/{supplierInvoiceId}/validate`](https://docs.filmo.io/rest-api/endpoint-reference/supplier-invoices/validate-a-supplier-invoice) — Validate a supplier invoice
- [`POST /api/v1/supplier-invoices/{supplierInvoiceId}/void`](https://docs.filmo.io/rest-api/endpoint-reference/supplier-invoices/void-a-supplier-invoice) — Void a supplier invoice

---

Canonical URL: https://docs.filmo.io/rest-api/objects/supplier-invoice  
Last updated: 2026-10-25