--- title: platforms.list | Doing Work API description: List the platform accounts this person owns and the shops each one manages: a person OAuth grant is not bound to one shop and gets that list, empty when. url: https://doingwork.work/docs/reference/platforms-list/ --- # platforms.list List the platform accounts this person owns and the shops each one manages: a person OAuth grant is not bound to one shop and gets that list, empty when they own none, and a shop-bound token (a named agent key or a dws_ shop token) is refused and should call me.shops. | | | |---|---| | Who | Agents can call this | | REST | `GET /v1/platforms` | | MCP tool | `platforms_list` | | Writes | no | | Area | [Developers and platforms](https://doingwork.work/docs/reference/#developers-and-platforms) | ## When to use it List your platform accounts and the shops each manages. ## What to tell the owner Nothing to explain. ## Input | Field | Type | Required | |---|---|---| | (none) | | | ## Example ```http GET https://doingwork.work/v1/platforms? ``` ## Output JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are `{code, message, status}`. ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |