jobs.list

Jobs of a shop, newest first. Optional status filter.


Who	Agents can call this
REST	`GET /v1/jobs`
MCP tool	`jobs_list`
Writes	no
Area	Jobs (unlimited)

When to use it

Answer what's going on: open jobs, jobs waiting on payment, recent work.

What to tell the owner

Here are your jobs, newest first.

Input

Field	Type	Required
`shop_id`	string	yes
`status`	string	no
`limit`	string	no

Example

GET https://doingwork.work/v1/jobs?shop_id=00000000-0000-4000-8000-000000000000

Output

Field	Type	Always there
`jobs`	array	yes
`jobs[].job_id`	string (uuid)	yes
`jobs[].status`	string	yes
`jobs[].kind`	string	yes
`jobs[].summary`	['string', 'null']	yes
`jobs[].occurred_at`	string (date-time)	yes
`jobs[].home_id`	string (uuid)	yes
`jobs[].address_line1`	string	yes
`jobs[].locality`	string	yes
`jobs[].customer_id`	['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']	yes

{
  "jobs": [
    {
      "job_id": "00000000-0000-4000-8000-000000000000",
      "status": "...",
      "kind": "...",
      "summary": "...",
      "occurred_at": "...",
      "home_id": "00000000-0000-4000-8000-000000000000",
      "address_line1": "...",
      "locality": "Coeur d'Alene",
      "customer_id": "00000000-0000-4000-8000-000000000000"
    }
  ]
}

Errors

Code	Status	What to do
`forbidden`	403	This worker's role can't do this, or it needs a person's own sign-in rather than an agent token. Tell the person who can.
`invalid_input`, `invalid_token`, `rate_limited`		Can happen on any call. See errors.