--- title: reports.quoteWinRate | Doing Work API description: Of the quotes made between two dates (inclusive, UTC) and sent, how many were signed, declined, or are still waiting. url: https://doingwork.work/docs/reference/reports-quotewinrate/ --- # reports.quoteWinRate Of the quotes made between two dates (inclusive, UTC) and sent, how many were signed, declined, or are still waiting. Win rate is signed over signed plus declined; null when none are decided yet. | | | |---|---| | Who | Agents can call this | | REST | `GET /v1/reports/quote-win-rate` | | MCP tool | `reports_quoteWinRate` | | Writes | no | | Area | [Costs, expenses and reports](https://doingwork.work/docs/reference/#costs-expenses-and-reports) | ## When to use it Of the quotes made between two dates (inclusive, UTC) and sent, how many were signed, declined, or are still waiting. Win rate is signed over signed plus declined; null when none are decided yet. ## What to tell the owner Tell them what you found in plain words. Don't read back raw fields. ## Input | Field | Type | Required | |---|---|---| | `shop_id` | string (uuid) | yes | | `from` | string | yes | | `to` | string | yes | ## Example ```http GET https://doingwork.work/v1/reports/quote-win-rate?shop_id=00000000-0000-4000-8000-000000000000&from=...&to=... ``` ## Output | Field | Type | Always there | |---|---|---| | `sent` | integer | yes | | `signed` | integer | yes | | `declined` | integer | yes | | `waiting` | integer | yes | | `win_rate` | ['number', 'null'] | yes | | `summary` | string | yes | | `display` | object | yes | | `display.kind` | string (one of table, cards, timeline, checklist, map, calendar, chart) | yes | | `display.title` | string | yes | | `display.columns` | array | no | | `display.columns[].key` | string | yes | | `display.columns[].label` | string | yes | | `display.fields` | array | no | | `display.fields[].key` | string | yes | | `display.fields[].label` | string | yes | ```json { "sent": 1, "signed": 1, "declined": 1, "waiting": 1, "win_rate": "...", "summary": "...", "display": { "kind": "table", "title": "..." } } ``` ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |