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.

Tool

filmo_supplier_invoices_get

Readsupplier-invoices:read

supplier-invoices:read
120/min
May need an add-on
Server annotation: Read-only
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_supplier_invoices_get",
    "arguments": {
      "supplierInvoiceId": "supp_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "supplierInvoiceNumber": "<supplierInvoiceNumber>",
      "status": "<status>",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}

generated from the schema

Arguments

supplierInvoiceIdstringRequired

Supplier invoice identifier.

Limits: min length 1

Result

On success the result carries structuredContent with data and meta. These are the attributes of data.

Show the attributes of data

idstring

Supplier invoice identifier.

supplierInvoiceNumberstring | null

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

statusstring

Status of the invoice within the purchasing cycle.

createdAtstring<date-time>

Creation date in ISO 8601 UTC.

updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

The same operation by REST

This tool runs GET /api/v1/supplier-invoices/{supplierInvoiceId}.

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.
Guides
Safe writes
An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.
Guides
Errors
A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?

Result

Arguments

Result

The same operation by REST

Related pages

Get a supplier invoice

Safe writes

Errors