---
title: "Onboarding Deck Area"
method: POST
path: "/onboarding/deck/area"
tags: ["onboarding"]
---

# Onboarding Deck Area

`POST /onboarding/deck/area`

Every pool place inside a map viewport, most prominent first.

Same bucket size as the deal: this is the same read, and a traveller
exploring a map asks it more than once.

## Request body

- DeckAreaRequest — No interests: an area search reveals everything in view, for anyone.
  - `city` string, required
  - `place_id` string, nullable
  - `bounds` AreaBounds, required — A map viewport, as the four edges Mapbox reports.
    - `south` number, required
    - `west` number, required
    - `north` number, required
    - `east` number, required

## Response `200`

Successful Response

- DeckAreaResponse
  - `cards` OnboardingDeckCard[], required
    - `place_id` string, required
    - `name` string, required
    - `locality` string, nullable, required
    - `image_url` string, required
    - `dist_km` integer, required
    - `lat` number, nullable
    - `lng` number, nullable
    - `gem_or_hit` string, required
    - `matched_subcategory` string, nullable, required
    - `why` string, required
    - `themes` string[], required
  - `total` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-10** `03a9621c5178` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stardrift/apis/fastapi/changes/onboarding/deck/area/post.md)

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/stardrift/apis/fastapi/revisions/03a9621c5178?raw)