homeowner.previewShops

Before sending, list the shops on Doing Work that would get your request, each with why it matches. Contacts no one. The customer can remove any; pass those to homeowner.sendRequest as exclude_shop_ids.

WhoAgents can call this
RESTGET /v1/homeowner/requests/preview
MCP toolhomeowner_previewShops
Writesno
AreaShop

When to use it

Requests and quotes are free for shops and customers. We will never charge lead or referral fees.

What to tell the owner

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

Input

FieldTypeRequired
request_idstring (uuid)yes

Example

GET https://doingwork.work/v1/homeowner/requests/preview?request_id=00000000-0000-4000-8000-000000000000

Output

FieldTypeAlways there
request_idstring (uuid)yes
categorystringyes
rankingstringyes
finding_shopsbooleanyes
shopsarrayyes
shops[].shop_idstring (uuid)yes
shops[].name['object', 'null']yes
shops[].reasonsarrayyes
nextstringyes
notestringyes
{
  "request_id": "00000000-0000-4000-8000-000000000000",
  "category": "...",
  "ranking": "...",
  "finding_shops": true,
  "shops": [
    {
      "shop_id": "00000000-0000-4000-8000-000000000000",
      "name": "Ruiz Plumbing",
      "reasons": [
        "..."
      ]
    }
  ],
  "next": "...",
  "note": "..."
}

Errors

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