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

WhoAgents can call this
RESTGET /v1/quotes/get
MCP toolquotes_get
Writesno
AreaShop

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

FieldTypeRequired
quote_idstring (uuid)yes

Example

GET https://doingwork.work/v1/quotes/get?quote_id=00000000-0000-4000-8000-000000000000

Output

FieldTypeAlways there
quote_idstring (uuid)yes
shop_idstring (uuid)yes
job_idstring (uuid)yes
customer_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
customer_name['string', 'null']yes
statusstring (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
currencystringyes
total_minorintegeryes
max_total_minor['integer', 'null']yes
created_atstring (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
versionsarrayyes
versions[].versionintegeryes
versions[].currencystringyes
versions[].total_minorintegeryes
versions[].max_total_minor['integer', 'null']yes
versions[].created_atstring (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[].viewsintegeryes
versions[].options['array', 'null']yes
versions[].tax['object', 'null']yes
versions[].linesarrayyes
versions[].lines[].positionintegeryes
versions[].lines[].descriptionstringyes
versions[].lines[].quantitynumberyes
versions[].lines[].unit_price_minorintegeryes
versions[].lines[].amount_minorintegeryes
versions[].lines[].option_key['string', 'null']yes
versions[].lines[].optionalbooleanyes
versions[].lines[].kindstringyes
versions[].lines[].taxablebooleanyes
versions[].lines[].sourcestringyes
next_actionsarrayyes
next_actions[].saystringyes
next_actions[].op['string', 'null']yes
next_actions[].whenstring (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_hintstringno
{
  "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

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.