# List quotes

> The list_quotes MCP tool: list quotes.

`list_quotes` · read-only

[REST: `GET /v1/quotes`](https://api.bymundi.com/docs/reference/quotes.list.md)

## 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)

```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
}
```