---
title: "People Map Search"
method: POST
path: "/v1/native/people-map/search"
tags: ["native"]
---

# People Map Search

`POST /v1/native/people-map/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/native/people-map/search`
- Auth: none declared

The people map, narrowed to who does what the customer typed.

Everyone on Mundane is a candidate wherever they are (the skill search
in `app.skill_search`, which never uses location to decide who matches),
ordered by Jev for what was typed. Pins follow the map's own rules: an
area never names or places anyone, and only workers who opted in appear
by handle. An area's figures cover the workers who matched, so a search
can say what one anonymous person in an area does -- still less than an
agent's skill search already returns for that worker, by handle. Picking
a pin only sets where the task happens; every later search is held to
that pin and radius as before.

## Headers

- `authorization` string

## Cookies

- `mundane_principal_session` string, nullable

## Request body

- PeopleSearchIn
  - `query` string, required

## Response `200`

Successful Response

- PeopleSearchOut
  - `query` string, required
  - `matching` string, required
  - `ranked_by` string, required
  - `matches` integer, required
  - `pins` PeoplePinOut[], required
    - `kind` string, required
    - `lat` number, required
    - `lng` number, required
    - `radius_km` number, required
    - `count` integer, required
    - `handle` string, nullable
    - `skills` string[], required
    - `services` string[], required
    - `rating` number, nullable
    - `completed_tasks` integer, required
    - `on_shift` integer, required
    - `rank` integer, nullable
    - `matched` string[]
    - `best` boolean

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