--- title: media.list | Doing Work API description: List the photos and videos you are allowed to see, with what the agent said each shows (summary), who provided each file (shop or customer), the channel it. url: https://doingwork.work/docs/reference/media-list/ --- # media.list List the photos and videos you are allowed to see, with what the agent said each shows (summary), who provided each file (shop or customer), the channel it arrived on, taken time, GPS location, heading and camera details. Filter by job, kind, words in the summary or transcript (q), summary status, distance from a point, taken time, or whether it has a location. | | | |---|---| | Who | Agents can call this | | REST | `GET /v1/media` | | MCP tool | `media_list` | | Writes | no | | Area | [Job photos](https://doingwork.work/docs/reference/#job-photos) | ## When to use it See which photos a job has, by stage (before, during, after). ## What to tell the owner Here are the photos on that job. ## Input | Field | Type | Required | |---|---|---| | `job_id` | string (uuid) | no | | `shop_id` | string (uuid) | no | | `near_lat` | number | no | | `near_lng` | number | no | | `radius_m` | number | no | | `taken_after` | string | no | | `taken_before` | string | no | | `has_location` | string (one of true, false) | no | | `sort` | string (one of uploaded, taken, taken_desc, distance) | no | | `limit` | integer | no | | `kind` | string (one of photo, video) | no | | `q` | string | no | | `summary_status` | string (one of summarized, needs_summary) | no | ## Example ```http GET https://doingwork.work/v1/media?job_id=00000000-0000-4000-8000-000000000000&shop_id=00000000-0000-4000-8000-000000000000&near_lat=...&near_lng=...&radius_m=...&taken_after=...&taken_before=...&has_location=true&sort=uploaded&limit=1&kind=photo&q=...&summary_status=summarized ``` ## 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 | |---|---|---| | `not_found` | 404 | No such record, or this worker can't see it. | | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |