Quotes

List quotes

Returns the quotes with their active version flattened, cursor-paginated.

Tool

filmo_quotes_list

Readquotes:read

quotes:read
120/min
Server annotation: Read-only
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_quotes_list",
    "arguments": {
      "limit": 20
    }
  }
}

{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "quoteNumber": "<quoteNumber>",
        "versionNumber": 1,
        "status": "draft",
        "operativeStatus": "pending",
        "issueDate": "2026-09-01T08:00:00Z",
        "validUntil": "2026-09-01T08:00:00Z",
        "startDate": "2026-09-01T08:00:00Z",
        "endDate": "2026-09-01T08:00:00Z",
        "currency": "EUR",
        "contact": {
          "id": "id_8f2a1c",
          "name": "Example"
        },
        "orderId": "orde_8f2a1c",
        "orderNumber": "<orderNumber>",
        "projectId": "proj_8f2a1c",
        "subTotal": "1234.50",
        "discountTotal": "1234.50",
        "taxesPrice": "1234.50",
        "netPrice": "1234.50",
        "grossPrice": "1234.50",
        "totalPaid": "1234.50",
        "createdAt": "2026-09-01T08:00:00Z",
        "updatedAt": "2026-09-01T08:00:00Z"
      }
    ],
    "pagination": {
      "nextCursor": "eyJvIjo1MH0",
      "hasMore": true,
      "total": 1
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

Filter by commercial or operational status. Strict per-subscription tenancy.

Arguments

limitintegerdefault:50

Page size (1-500). Defaults to 50.

Limits: min 1, max 500

cursorstring

Opaque cursor of the page to return. Pass the value of pagination.nextCursor from the previous response; treat it as opaque.

Limits: max length 200

qstring

Free-text search on the quote number, the order number, the notes, the header text and the client name.

Limits: min length 1, max length 200

sortstring

Sort order: up to 3 comma-separated fields, each with a leading "-" for descending (e.g. "-updatedAt,name"). Sortable fields: createdAt, updatedAt, quoteNumber, issueDate, startDate, endDate, subTotal, grossPrice, operativeStatus. Defaults to "-createdAt". Ties are broken by id, so the order is stable across pages, and a cursor is bound to the sort it was issued with.

Limits: max length 200

operativeStatusstring

Filter by commercial status of the active version: pending (awaiting an answer), confirmed (accepted), cancelled (rejected/cancelled) or superseded (replaced by another version).

Available options: pending, confirmed, cancelled, superseded

operativeStatusesstring[]

Filter by operativeStatus, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Available options: pending, confirmed, cancelled, superseded

Limits: min 1 items, max 50 items

contactIdstring

Filter by quote contact identifier.

Limits: min length 1, max length 100

contactIdsstring[]

Filter by contactId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Limits: min 1 items, max 50 items, each min length 1, each max length 100

orderIdstring

Filter by identifier of the order linked to the quote.

Limits: min length 1, max length 100

orderIdsstring[]

Filter by orderId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Limits: min 1 items, max 50 items, each min length 1, each max length 100

projectIdstring

Filter by identifier of the project linked to the quote.

Limits: min length 1, max length 100

projectIdsstring[]

Filter by projectId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Limits: min 1 items, max 50 items, each min length 1, each max length 100

includeTotalbooleandefault:false

Set it to true to include pagination.total, the number of results that match the filters across all pages. Off by default.

dateFiltersobject

Date filters by field. A bare day (YYYY-MM-DD) is read in the business timezone; an ISO 8601 instant with offset is applied as is by gte, lte, gt and lt, while on widens it to the whole business day that contains it. Fields: created, issueDate, updated, validUntil.

Show child attributes

dateFilters.createdobject

Show child attributes

dateFilters.created.gtestring

From this day or instant, inclusive.

dateFilters.created.ltestring

Up to this day or instant, inclusive.

dateFilters.created.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.created.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.created.onstring

Exactly that day; an instant means the whole business day that contains it.

dateFilters.issueDateobject

Show child attributes

dateFilters.issueDate.gtestring

From this day or instant, inclusive.

dateFilters.issueDate.ltestring

Up to this day or instant, inclusive.

dateFilters.issueDate.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.issueDate.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.issueDate.onstring

Exactly that day; an instant means the whole business day that contains it.

dateFilters.updatedobject

Show child attributes

dateFilters.updated.gtestring

From this day or instant, inclusive.

dateFilters.updated.ltestring

Up to this day or instant, inclusive.

dateFilters.updated.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.updated.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.updated.onstring

Exactly that day; an instant means the whole business day that contains it.

dateFilters.validUntilobject

Show child attributes

dateFilters.validUntil.gtestring

From this day or instant, inclusive.

dateFilters.validUntil.ltestring

Up to this day or instant, inclusive.

dateFilters.validUntil.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.validUntil.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.validUntil.onstring

Exactly that day; an instant means the whole business day that contains it.

Result

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

Show the attributes of data

idstring

Unique quote identifier (container).

quoteNumberstring

Human-readable quote number.

versionNumberinteger

Number of the active version of the quote.

statusstring

Document lifecycle status of the active version: draft or validated (validated and numbered).

Available options: draft, validated

operativeStatusstring

Commercial status of the active version: pending (awaiting an answer), confirmed (accepted), cancelled (rejected/cancelled) or superseded (replaced).

Available options: pending, confirmed, cancelled, superseded

issueDatestring<date-time> | null

Issue date of the active version in ISO 8601 with offset; null if not issued.

validUntilstring<date-time> | null

Validity date of the quote in ISO 8601 with offset; null if not set.

startDatestring<date-time>

Start of the quoted rental period in ISO 8601 with offset.

endDatestring<date-time>

End of the quoted rental period in ISO 8601 with offset.

currencystring

Quote currency as an ISO 4217 code (for example "EUR").

contactobject | null

Compact reference to the quote contact; null if none.

Show child attributes

contact.idstring

Unique contact identifier.

contact.namestring

Contact name.

orderIdstring | null

Identifier of the linked order; null if not linked.

orderNumberstring | null

Number of the linked order; null if not linked.

projectIdstring | null

Identifier of the linked project; null if not linked.

subTotalstring

Subtotal before discounts and taxes, as a decimal string "1234.50" (ROUND_HALF_UP).