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

# Onboarding Deck Area

`POST /onboarding/deck/area`

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/onboarding/deck/area`
- Auth: none declared

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. `themes` is the traveller's own category filter, not their picks — empty means everything.
  - `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
  - `themes` string[]

## 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-11** `5acadde833b2`: 1 info
  - added the new optional request property `themes`
- **2026-09-10** `03a9621c5178`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stardrift/apis/stardrift-api/changes/onboarding/deck/area/post.md)

---

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