shops.transfers

Hand-offs of a shop, newest first. The owner sees all of them; a worker sees only the ones naming them. Without shop_id: every hand-off naming you.


Who	Agents can call this
REST	`GET /v1/shops/transfers`
MCP tool	`shops_transfers`
Writes	no
Area	Shop

When to use it

Hand-offs of a shop, newest first. The owner sees all of them; a worker sees only the ones naming them.

What to tell the owner

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

Input

Field	Type	Required
`shop_id`	string (uuid)	no

Example

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

Output

Field	Type	Always there
`transfers`	array	yes
`transfers[].transfer_id`	string (uuid)	yes
`transfers[].shop_id`	string (uuid)	yes
`transfers[].shop`	string	yes
`transfers[].from_person_id`	string (uuid)	yes
`transfers[].from_name`	['string', 'null']	yes
`transfers[].to_person_id`	string (uuid)	yes
`transfers[].to_name`	['string', 'null']	yes
`transfers[].status`	string	yes
`transfers[].old_owner_stays_as_office`	boolean	yes
`transfers[].started_at`	string (date-time)	yes
`transfers[].expires_at`	string (date-time)	yes
`transfers[].completed_at`	['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')']	yes
`transfers[].cancelled_at`	['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')']	yes
`transfers[].processor_reverify_status`	string	yes
`transfers[].you_are`	string	yes

{
  "transfers": [
    {
      "transfer_id": "00000000-0000-4000-8000-000000000000",
      "shop_id": "00000000-0000-4000-8000-000000000000",
      "shop": "...",
      "from_person_id": "00000000-0000-4000-8000-000000000000",
      "from_name": "...",
      "to_person_id": "00000000-0000-4000-8000-000000000000",
      "to_name": "...",
      "status": "...",
      "old_owner_stays_as_office": true,
      "started_at": "...",
      "expires_at": "...",
      "completed_at": "...",
      "cancelled_at": "...",
      "processor_reverify_status": "...",
      "you_are": "..."
    }
  ]
}

Errors

Code	Status	What to do
`invalid_input`, `invalid_token`, `rate_limited`		Can happen on any call. See errors.