--- title: reports.today | Doing Work API description: The shop's today queues in one call: visits today, visits in the next 7 days with nobody assigned, new requests, quotes and change orders waiting on the. url: https://doingwork.work/docs/reference/reports-today/ --- # reports.today The shop's today queues in one call: visits today, visits in the next 7 days with nobody assigned, new requests, quotes and change orders waiting on the customer, overdue and draft invoices, done jobs not invoiced, time waiting for approval, approvals waiting on the owner, open tasks due by today and done visits with no quote sent yet. Each list shows the first 25 with the full count. | | | |---|---| | Who | Agents can call this | | REST | `GET /v1/reports/today` | | MCP tool | `reports_today` | | Writes | no | | Area | [Costs, expenses and reports](https://doingwork.work/docs/reference/#costs-expenses-and-reports) | ## When to use it The shop's today queues in one call: visits today, visits in the next 7 days with nobody assigned, new requests, quotes and change orders waiting on the customer, overdue and draft invoices, done jobs not invoiced, time waiting for approval, approvals waiting on the owner, open tasks due by today and done visits with no quote sent yet. Each list shows the first 25 with the full count. ## 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 | | `date` | string | no | ## Example ```http GET https://doingwork.work/v1/reports/today?shop_id=00000000-0000-4000-8000-000000000000 ``` ## Output | Field | Type | Always there | |---|---|---| | `date` | string | yes | | `time_zone` | string | yes | | `currency` | string | yes | | `visits_today` | object | yes | | `visits_today.count` | integer | yes | | `visits_today.items` | array | yes | | `visits_today.items[].visit_id` | string (uuid) | yes | | `visits_today.items[].job_id` | string (uuid) | yes | | `visits_today.items[].job_summary` | ['string', 'null'] | yes | | `visits_today.items[].customer_name` | ['string', 'null'] | yes | | `visits_today.items[].title` | ['string', 'null'] | yes | | `visits_today.items[].starts_at` | string (date-time) | yes | | `visits_today.items[].ends_at` | string (date-time) | yes | | `visits_today.items[].status` | string | yes | | `visits_today.items[].assignees` | array | yes | | `unassigned_visits` | object | yes | | `unassigned_visits.count` | integer | yes | | `unassigned_visits.items` | array | yes | | `unassigned_visits.items[].visit_id` | string (uuid) | yes | | `unassigned_visits.items[].job_id` | string (uuid) | yes | | `unassigned_visits.items[].job_summary` | ['string', 'null'] | yes | | `unassigned_visits.items[].customer_name` | ['string', 'null'] | yes | | `unassigned_visits.items[].title` | ['string', 'null'] | yes | | `unassigned_visits.items[].starts_at` | string (date-time) | yes | | `unassigned_visits.items[].ends_at` | string (date-time) | yes | | `unassigned_visits.items[].status` | string | yes | | `unassigned_visits.items[].assignees` | array | yes | | `new_requests` | object | yes | | `new_requests.count` | integer | yes | | `new_requests.items` | array | yes | | `new_requests.items[].request_id` | string (uuid) | yes | | `new_requests.items[].title` | string | yes | | `new_requests.items[].source` | string | yes | | `new_requests.items[].customer_id` | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes | | `new_requests.items[].created_at` | string (date-time) | yes | | `quotes_waiting` | object | yes | | `quotes_waiting.count` | integer | yes | | `quotes_waiting.items` | array | yes | | `quotes_waiting.items[].quote_id` | string (uuid) | yes | | `quotes_waiting.items[].job_id` | string (uuid) | yes | | `quotes_waiting.items[].customer_name` | ['string', 'null'] | yes | | `quotes_waiting.items[].doc_no` | integer | yes | | `quotes_waiting.items[].doc_label` | string | yes | | `quotes_waiting.items[].total_minor` | integer | yes | | `quotes_waiting.items[].total_text` | string | yes | | `quotes_waiting.items[].sent_at` | string (date-time) | yes | | `quotes_waiting.items[].days_waiting` | integer | yes | | `change_orders_waiting` | object | yes | | `change_orders_waiting.count` | integer | yes | | `change_orders_waiting.items` | array | yes | | `change_orders_waiting.items[].change_order_id` | string (uuid) | yes | | `change_orders_waiting.items[].job_id` | string (uuid) | yes | | `change_orders_waiting.items[].number` | integer | yes | | `change_orders_waiting.items[].total_minor` | integer | yes | | `change_orders_waiting.items[].sent_at` | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes | | `invoices_overdue` | object | yes | | `invoices_overdue.count` | integer | yes | | `invoices_overdue.items` | array | yes | | `invoices_overdue.items[].invoice_id` | string (uuid) | yes | | `invoices_overdue.items[].job_id` | string (uuid) | yes | | `invoices_overdue.items[].customer_name` | ['string', 'null'] | yes | | `invoices_overdue.items[].doc_no` | integer | yes | | `invoices_overdue.items[].doc_label` | string | yes | | `invoices_overdue.items[].owed_minor` | integer | yes | | `invoices_overdue.items[].owed_text` | string | yes | | `invoices_overdue.items[].due_on` | string | yes | | `invoices_overdue.items[].days_overdue` | integer | yes | | `draft_invoices` | object | yes | | `draft_invoices.count` | integer | yes | | `draft_invoices.items` | array | yes | | `draft_invoices.items[].invoice_id` | string (uuid) | yes | | `draft_invoices.items[].job_id` | string (uuid) | yes | | `draft_invoices.items[].customer_name` | ['string', 'null'] | yes | | `draft_invoices.items[].doc_no` | integer | yes | | `draft_invoices.items[].doc_label` | string | yes | | `draft_invoices.items[].total_minor` | integer | yes | | `draft_invoices.items[].total_text` | string | yes | | `draft_invoices.items[].created_at` | string (date-time) | yes | | `jobs_to_invoice` | object | yes | | `jobs_to_invoice.count` | integer | yes | | `jobs_to_invoice.items` | array | yes | | `jobs_to_invoice.items[].job_id` | string (uuid) | yes | | `jobs_to_invoice.items[].summary` | ['string', 'null'] | yes | | `jobs_to_invoice.items[].customer_name` | ['string', 'null'] | yes | | `jobs_to_invoice.items[].occurred_at` | string (date-time) | yes | | `time_to_approve` | object | yes | | `time_to_approve.entries` | integer | yes | | `time_to_approve.minutes` | integer | yes | | `time_to_approve.people` | integer | yes | | `time_to_approve.oldest_started_at` | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes | | `approvals_pending` | object | yes | | `approvals_pending.count` | integer | yes | | `approvals_pending.items` | array | yes | | `approvals_pending.items[].approval_id` | string (uuid) | yes | | `approvals_pending.items[].op_id` | string | yes | | `approvals_pending.items[].amount_minor` | ['integer', 'null'] | yes | | `approvals_pending.items[].requested_by` | string (uuid) | yes | | `approvals_pending.items[].expires_at` | string (date-time) | yes | | `open_tasks` | object | yes | | `open_tasks.count` | integer | yes | | `open_tasks.items` | array | yes | | `open_tasks.items[].task_id` | string (uuid) | yes | | `open_tasks.items[].title` | string | yes | | `open_tasks.items[].job_id` | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes | | `open_tasks.items[].job_summary` | ['string', 'null'] | yes | | `open_tasks.items[].assignee_id` | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes | | `open_tasks.items[].due_at` | string (date-time) | yes | | `open_tasks.items[].overdue` | boolean | yes | | `capacity` | object | yes | | `capacity.time_zone` | string | yes | | `capacity.hours_source` | string | yes | | `capacity.visit_minutes` | integer | yes | | `capacity.days` | array | yes | | `capacity.days[].date` | string | yes | | `capacity.days[].weekday` | string | yes | | `capacity.days[].open_minutes` | integer | yes | | `capacity.days[].booked_minutes` | integer | yes | | `capacity.days[].free_minutes` | integer | yes | | `capacity.days[].percent_booked` | integer | yes | | `capacity.days[].fits` | integer | yes | | `capacity.days[].workers` | integer | yes | | `capacity.next_actions` | array | yes | | `capacity.next_actions[].say` | string | yes | | `capacity.next_actions[].op` | ['string', 'null'] | yes | | `capacity.next_actions[].when` | string (one of now, later, check, tell_human) | yes | | `capacity.next_actions[].due_at` | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | no | | `capacity.next_actions[].args_hint` | string | no | | `quote_queue` | object | yes | | `quote_queue.count` | integer | yes | | `quote_queue.items` | array | yes | | `quote_queue.items[].visit_id` | string (uuid) | yes | | `quote_queue.items[].job_id` | string (uuid) | yes | | `quote_queue.items[].job_summary` | ['string', 'null'] | yes | | `quote_queue.items[].customer_name` | ['string', 'null'] | yes | | `quote_queue.items[].done_at` | string (date-time) | 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 | | `next_steps` | array | yes | | `next_steps[].say` | string | yes | | `next_steps[].op` | ['string', 'null'] | yes | | `next_steps[].when` | string (one of now, later, check, tell_human) | yes | | `next_steps[].due_at` | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | no | | `next_steps[].args_hint` | string | no | ```json { "date": "...", "time_zone": "...", "currency": "...", "visits_today": { "count": 1, "items": [ { "visit_id": "00000000-0000-4000-8000-000000000000", "job_id": "00000000-0000-4000-8000-000000000000", "job_summary": "...", "customer_name": "...", "title": "...", "starts_at": "...", "ends_at": "...", "status": "...", "assignees": [ "00000000-0000-4000-8000-000000000000" ] } ] }, "unassigned_visits": { "count": 1, "items": [ { "visit_id": "00000000-0000-4000-8000-000000000000", "job_id": "00000000-0000-4000-8000-000000000000", "job_summary": "...", "customer_name": "...", "title": "...", "starts_at": "...", "ends_at": "...", "status": "...", "assignees": [ "00000000-0000-4000-8000-000000000000" ] } ] }, "new_requests": { "count": 1, "items": [ { "request_id": "00000000-0000-4000-8000-000000000000", "title": "...", "source": "...", "customer_id": "00000000-0000-4000-8000-000000000000", "created_at": "..." } ] }, "quotes_waiting": { "count": 1, "items": [ { "quote_id": "00000000-0000-4000-8000-000000000000", "job_id": "00000000-0000-4000-8000-000000000000", "customer_name": "...", "doc_no": 1, "doc_label": "...", "total_minor": 50000, "total_text": "...", "sent_at": "...", "days_waiting": 1 } ] }, "change_orders_waiting": { "count": 1, "items": [ { "change_order_id": "00000000-0000-4000-8000-000000000000", "job_id": "00000000-0000-4000-8000-000000000000", "number": 1, "total_minor": 50000, "sent_at": "..." } ] }, "invoices_overdue": { "count": 1, "items": [ { "invoice_id": "00000000-0000-4000-8000-000000000000", "job_id": "00000000-0000-4000-8000-000000000000", "customer_name": "...", "doc_no": 1, "doc_label": "...", "owed_minor": 50000, "owed_text": "...", "due_on": "...", "days_overdue": 1 } ] }, "draft_invoices": { "count": 1, "items": [ { "invoice_id": "00000000-0000-4000-8000-000000000000", "job_id": "00000000-0000-4000-8000-000000000000", "customer_name": "...", "doc_no": 1, "doc_label": "...", "total_minor": 50000, "total_text": "...", "created_at": "..." } ] }, "jobs_to_invoice": { "count": 1, "items": [ { "job_id": "00000000-0000-4000-8000-000000000000", "summary": "...", "customer_name": "...", "occurred_at": "..." } ] }, "time_to_approve": { "entries": 1, "minutes": 1, "people": 1, "oldest_started_at": "..." }, "approvals_pending": { "count": 1, "items": [ { "approval_id": "00000000-0000-4000-8000-000000000000", "op_id": "00000000-0000-4000-8000-000000000000", "amount_minor": "...", "requested_by": "00000000-0000-4000-8000-000000000000", "expires_at": "..." } ] }, "open_tasks": { "count": 1, "items": [ { "task_id": "00000000-0000-4000-8000-000000000000", "title": "...", "job_id": "00000000-0000-4000-8000-000000000000", "job_summary": "...", "assignee_id": "00000000-0000-4000-8000-000000000000", "due_at": "...", "overdue": true } ] }, "capacity": { "time_zone": "...", "hours_source": "...", "visit_minutes": 1, "days": [ { "date": "...", "weekday": "...", "open_minutes": 1, "booked_minutes": 1, "free_minutes": 1, "percent_booked": 1, "fits": 1, "workers": 1 } ], "next_actions": [ { "say": "...", "op": "...", "when": "now" } ] }, "quote_queue": { "count": 1, "items": [ { "visit_id": "00000000-0000-4000-8000-000000000000", "job_id": "00000000-0000-4000-8000-000000000000", "job_summary": "...", "customer_name": "...", "done_at": "..." } ] }, "summary": "...", "display": { "kind": "table", "title": "..." }, "next_steps": [ { "say": "...", "op": "...", "when": "now" } ] } ``` ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |