---
title: "Skill Search Anywhere"
method: POST
path: "/v1/workers/skill-search"
tags: ["workers"]
---

# Skill Search Anywhere

`POST /v1/workers/skill-search`

## 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/skill-search`
- Auth: none declared

Verified workers whose own skills match `query`, wherever they are,
ordered by Jev for `goal`. Areas and rounded distances only.

## Headers

- `authorization` string

## Request body

- SkillSearchRequest
  - `query` string, required
  - `goal` string, nullable
  - `k` integer
  - `near` SkillSearchNear
    - `lat` number, required
    - `lng` number, required
  - `capability` string, nullable
  - `max_rate_minor` integer, nullable
  - `min_rating` number
  - `min_rating_count` integer
  - `live_now` boolean
  - `chain_ok` boolean
  - `interactive_ok` boolean

## Response `200`

Successful Response

- SkillSearchOut
  - `matching` 'meaning' | 'text', required
  - `ranked_by` 'jev' | 'similarity', required
  - `best_worker_id` string, nullable, required
  - `workers` SkillSearchWorker[], required
    - `worker_id` string, required
    - `handle` string, required
    - `skills` string[], required
    - `capabilities` string[], required
    - `matched_on` string, nullable, required
    - `similarity` number, nullable, required
    - `jev_rank` integer, nullable, required
    - `fits` number, nullable, required
    - `ask_rate_minor` integer, required
    - `ask_rate` string, required
    - `ask_rate_basis` 'per_task'
    - `currency` string, required
    - `rate_card` RateCardEntry[], required
      - `label` string, required
      - `rate_minor` integer, required
    - `rating` number, required
    - `rating_count` integer, required
    - `completed_tasks` integer, required
    - `live_now` boolean, required
    - `has_vehicle` boolean, required
    - `chain_ok` boolean, required
    - `interactive_ok` boolean
    - `interactive_rate_minor` integer, nullable
    - `country` string, nullable, required
    - `area` SkillSearchArea, required
      - `lat` number, required
      - `lng` number, required
      - `radius_km` number, required
    - `distance_km` integer, nullable, required

## 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)