Supplier invoices

Get a supplier invoice

Returns an invoice received from a supplier by its identifier, the same compact card as GET /api/v1/supplier-invoices.

GET
/api/v1/supplier-invoices/{supplierInvoiceId}

Request examples

curl https://app.filmo.io/api/v1/supplier-invoices/supp_8f2a1c \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": {
    "id": "supplier_invoice_9f3a2b",
    "supplierInvoiceNumber": "2026-0001",
    "status": "Example status",
    "createdAt": "2026-09-01T08:00:00.000Z",
    "updatedAt": "2026-09-01T08:00:00.000Z"
  }
}

Generated from the schema

Authorizations

Bearer API key with the scope below. supplier-invoices:read

Headers

If-None-Matchstring

Conditional read: the ETag of the copy you already have. If the resource has not changed, the response is 304 with no body.

Example:"\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""

Path parameters

supplierInvoiceIdstringRequired

Supplier invoice identifier.

Limits: min length 1

Response

application/json

Successful response.

Response schema: SupplierInvoiceDto

Envelope: SupplierInvoiceResponse. meta.warnings is present only when the operation is deprecated.

Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag

dataobject

Invoice received from a supplier.

Show child attributes
data.idstring

Supplier invoice identifier.

data.supplierInvoiceNumberstring | null

Number the supplier put on the invoice; null if it was not recorded.

data.statusstring

Status of the invoice within the purchasing cycle.

data.createdAtstring<date-time>

Creation date in ISO 8601 UTC.

data.updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

metaobject

Additional information about the response.

Show child attributes
meta.warningsobject[]

Lifecycle warnings; present only when the operation is deprecated.

Show child attributes
meta.warnings.codestring

Stable warning code.

Available options: deprecated

meta.warnings.messagestring

For people: what is deprecated, until when, and what to use.

meta.warnings.sunsetstring

Day (YYYY-MM-DD) the operation stops being served.

meta.warnings.replacementstring | null

operationId of the operation to use instead, or null if there is none.

Errors

StatusCodesMeaning
402addon_requiredThe account plan does not include the add-on this operation needs; requiredAddon names it.
404not_foundIt does not exist or is outside the scope of the API key.

401, 403, 429, 500 can be returned by any operation. Errors

Deprecation

This operation is not deprecated. Deprecations are announced with a Deprecation header and a sunset date. Versioning policy