quotes.get
One customer quote in this shop: doc_no and doc_label (Q-12), status, every version with its lines and totals, the job and customer, when it was sent and viewed, and the signer name and signed time once someone has signed. Read only. This is a quote, not an AI line draft (that is quotes.draft).
| Who | Agents can call this |
| REST | GET /v1/quotes/get |
| MCP tool | quotes_get |
| Writes | no |
| Area | Shop |
When to use it
One customer quote in this shop: doc_no and doc_label (Q-12), status, every version with its lines and totals, the job and customer, when it was sent and viewed, and the signer name and signed time once someone has signed. Read only.
What to tell the owner
Tell them what you found in plain words. Don't read back raw fields.
Input
| Field | Type | Required |
|---|---|---|
quote_id | string (uuid) | yes |
Example
GET https://doingwork.work/v1/quotes/get?quote_id=00000000-0000-4000-8000-000000000000Output
| Field | Type | Always there |
|---|---|---|
quote_id | string (uuid) | yes |
shop_id | string (uuid) | yes |
job_id | string (uuid) | yes |
customer_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes |
customer_name | ['string', 'null'] | yes |
status | string (one of draft, sent, signed, declined, superseded, withdrawn) | yes |
doc_no | ['integer', 'null'] | yes |
doc_label | ['string', 'null'] | yes |
signer_name | ['string', 'null'] | yes |
signed_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
currency | string | yes |
total_minor | integer | yes |
max_total_minor | ['integer', 'null'] | yes |
created_at | string (date-time) | yes |
last_sent_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
first_viewed_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
last_viewed_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
versions | array | yes |
versions[].version | integer | yes |
versions[].currency | string | yes |
versions[].total_minor | integer | yes |
versions[].max_total_minor | ['integer', 'null'] | yes |
versions[].created_at | string (date-time) | yes |
versions[].first_viewed_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
versions[].last_viewed_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
versions[].views | integer | yes |
versions[].options | ['array', 'null'] | yes |
versions[].tax | ['object', 'null'] | yes |
versions[].lines | array | yes |
versions[].lines[].position | integer | yes |
versions[].lines[].description | string | yes |
versions[].lines[].quantity | number | yes |
versions[].lines[].unit_price_minor | integer | yes |
versions[].lines[].amount_minor | integer | yes |
versions[].lines[].option_key | ['string', 'null'] | yes |
versions[].lines[].optional | boolean | yes |
versions[].lines[].kind | string | yes |
versions[].lines[].taxable | boolean | yes |
versions[].lines[].source | string | yes |
next_actions | array | yes |
next_actions[].say | string | yes |
next_actions[].op | ['string', 'null'] | yes |
next_actions[].when | string (one of now, later, check, tell_human) | yes |
next_actions[].due_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | no |
next_actions[].args_hint | string | no |
{
"quote_id": "00000000-0000-4000-8000-000000000000",
"shop_id": "00000000-0000-4000-8000-000000000000",
"job_id": "00000000-0000-4000-8000-000000000000",
"customer_id": "00000000-0000-4000-8000-000000000000",
"customer_name": "...",
"status": "draft",
"doc_no": "...",
"doc_label": "...",
"signer_name": "...",
"signed_at": "...",
"currency": "...",
"total_minor": 50000,
"max_total_minor": "...",
"created_at": "...",
"last_sent_at": "...",
"first_viewed_at": "...",
"last_viewed_at": "...",
"versions": [
{
"version": 1,
"currency": "...",
"total_minor": 50000,
"max_total_minor": "...",
"created_at": "...",
"first_viewed_at": "...",
"last_viewed_at": "...",
"views": 1,
"options": "...",
"tax": "...",
"lines": [
{
"position": 1,
"description": "40 gallon gas heater, installed",
"quantity": "...",
"unit_price_minor": 50000,
"amount_minor": 50000,
"option_key": "...",
"optional": true,
"kind": "...",
"taxable": true,
"source": "..."
}
]
}
],
"next_actions": [
{
"say": "...",
"op": "...",
"when": "now"
}
]
}Errors
| Code | Status | What to do |
|---|---|---|
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |