bymundi API

List quotes

The list_quotes MCP tool: list quotes.

list_quotes · read-only

REST: GET /v1/quotes

What the model reads

Lists the agency's quotes, most recently changed first, each with its lines and totals. Filter by tripId (a trip's quotes), status, updatedSince, acceptedSince and up to 5 metadata key/value pairs. Pass nextCursor back as cursor for the next page.

Permissions: quotes:read.

Input

Field Type Required Description
tripId uuid
limit integer 1–100, default 25
cursor string max 500 chars
sort "updatedAt" | "-updatedAt" | "createdAt" | "-createdAt" default "-updatedAt"
status "draft" | "sent" | "accepted" | "rejected" | "expired" | "superseded"
updatedSince datetime
acceptedSince datetime Only quotes accepted at or after this instant — the 'quote accepted' polling trigger.
metadata object

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tripId": {
      "type": "string",
      "format": "uuid"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "sort": {
      "type": "string",
      "enum": [
        "updatedAt",
        "-updatedAt",
        "createdAt",
        "-createdAt"
      ],
      "default": "-updatedAt"
    },
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "sent",
        "accepted",
        "rejected",
        "expired",
        "superseded"
      ]
    },
    "updatedSince": {
      "type": "string",
      "format": "date-time"
    },
    "acceptedSince": {
      "type": "string",
      "format": "date-time",
      "description": "Only quotes accepted at or after this instant — the 'quote accepted' polling trigger."
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      },
      "propertyNames": {
        "pattern": "^[A-Za-z0-9_.-]{1,40}$"
      }
    }
  },
  "additionalProperties": false
}