quotes.list

Customer quotes in one shop, newest first. Filter by job_id, status, or both. Read only. Send shop_id or job_id. A shop you are not a member of is refused, and a job you cannot access is not found.

WhoAgents can call this
RESTGET /v1/quotes
MCP toolquotes_list
Writesno
AreaShop

When to use it

Customer quotes in one shop, newest first. Filter by job_id, status, or both.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

FieldTypeRequired
shop_idstring (uuid)no
job_idstring (uuid)no
statusstring (one of draft, sent, signed, declined, superseded, withdrawn)no
limitintegerno
cursorstringno

Example

GET https://doingwork.work/v1/quotes?shop_id=00000000-0000-4000-8000-000000000000&job_id=00000000-0000-4000-8000-000000000000&status=draft&limit=1&cursor=...

Output

FieldTypeAlways there
dataarrayyes
data[].quote_idstring (uuid)yes
data[].job_idstring (uuid)yes
data[].customer_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
data[].customer_name['string', 'null']yes
data[].statusstring (one of draft, sent, signed, declined, superseded, withdrawn)yes
data[].currencystringyes
data[].total_minorintegeryes
data[].total_textstringyes
data[].doc_nointegeryes
data[].doc_labelstringyes
data[].created_atstring (date-time)yes
data[].last_sent_at['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')']yes
data[].last_viewed_at['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')']yes
next_cursor['string', 'null']yes
time_zonestringyes
summarystringyes
displayobjectyes
display.kindstring (one of table, cards, timeline, checklist, map, calendar, chart)yes
display.titlestringyes
display.columnsarrayno
display.columns[].keystringyes
display.columns[].labelstringyes
display.fieldsarrayno
display.fields[].keystringyes
display.fields[].labelstringyes
{
  "data": [
    {
      "quote_id": "00000000-0000-4000-8000-000000000000",
      "job_id": "00000000-0000-4000-8000-000000000000",
      "customer_id": "00000000-0000-4000-8000-000000000000",
      "customer_name": "...",
      "status": "draft",
      "currency": "...",
      "total_minor": 50000,
      "total_text": "...",
      "doc_no": 1,
      "doc_label": "...",
      "created_at": "...",
      "last_sent_at": "...",
      "last_viewed_at": "..."
    }
  ],
  "next_cursor": "...",
  "time_zone": "...",
  "summary": "...",
  "display": {
    "kind": "table",
    "title": "..."
  }
}

Errors

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