---
title: "Claim Price Watch Request"
method: POST
path: "/price-watches/requests/{token}/claim"
tags: ["price-watches"]
---

# Claim Price Watch Request

`POST /price-watches/requests/{token}/claim`

Turn a parked request into a trip and a route watch for the signed-in
account whose email asked for it.

## Path parameters

- `token` string, required

## Response `200`

Successful Response

- PriceWatchClaimOut
  - `ok` boolean, required
  - `reason` string, nullable
  - `limit` integer, nullable
  - `trip_id` string, nullable
  - `trip_title` string, nullable
  - `route` string, nullable
  - `watches` PriceWatchView[]
    - `id` string, required
    - `kind` 'itinerary' | 'route'
    - `journey_id` string, nullable
    - `status` string, required
    - `route` string, required
    - `outbound_date` string, date, required
    - `return_date` string, date, nullable
    - `airline` string, nullable
    - `policy` union, required
      - PeriodicPolicy — A check-in N times a week, whatever the price did.
        - `kind` 'periodic'
        - `times_per_week` integer, required
      - OnChangePolicy — Told when the price moves by at least the user's own percent or amount; any move when they named neither.
        - `kind` 'on_change'
        - `min_change_pct` number, nullable
        - `min_change_amount` number, nullable
    - `currency` string, required
    - `saved_price` number, required
    - `last_told_price` number, required
    - `last_price` number, nullable
    - `cheapest_option` string, nullable
    - `price_level` string, nullable
    - `last_checked_at` string, date-time, nullable
    - `last_found_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-22** `750ef040fb57` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stardrift/apis/fastapi/changes/price-watches/requests/:token/claim/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/ae2c9c9f8e5d?raw)