---
title: "Search Workers"
method: GET
path: "/v1/workers"
tags: ["workers"]
---

# Search Workers

`GET /v1/workers`

## Request

- Base URL: `https://api.mundane.market` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mundane.market/v1/workers`
- Auth: none declared

## Query parameters

- `lat` number, required
- `lng` number, required
- `radius_km` number
- `capability` string, nullable
- `skill` string, nullable
- `min_rating` number
- `min_rating_count` integer
- `max_rate_minor` integer, nullable
- `available_at` string, date-time, nullable
- `live_now` boolean
- `chain_ok` boolean
- `interactive_ok` boolean
- `limit` integer

## Headers

- `authorization` string

## Response `200`

Successful Response

- WorkerSummary[]
  - `worker_id` string, required
  - `handle` string, required
  - `rating` number, required
  - `rating_count` integer, required
  - `completed_tasks` integer, required
  - `capabilities` string[]
  - `skills` string[]
  - `rate_card` RateCardEntry[]
    - `label` string, required
    - `rate_minor` integer, required
  - `ask_rate_minor` integer, required
  - `ask_rate_basis` 'per_task'
  - `currency` string, required
  - `distance_km` number, required
  - `match_score` number, required
  - `verification_status` string, required
  - `live_now` boolean, required
  - `live_until` string, date-time, nullable, required
  - `chain_ok` boolean
  - `interactive_ok` boolean
  - `interactive_rate_minor` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mundane/apis/mundane-api.md) · [All operations](https://skmtc.dev/mundane/apis/mundane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mundane/apis/mundane-api/revisions/f1cba6e69834?raw)