---
title: "Create Price Watch Request"
method: POST
path: "/price-watches/requests"
tags: ["price-watches"]
---

# Create Price Watch Request

`POST /price-watches/requests`

Validate and price the route, park it, and hand back today's fare.

## Request body

- PriceWatchRequestIn
  - `email` string, email, required
  - `origins` string[], required
  - `destinations` string[], required
  - `outbound_date` string, required
  - `return_date` string, nullable
  - `currency` string

## Response `200`

Successful Response

- PriceWatchRequestOut
  - `token` string, required
  - `route` string, required
  - `outbound_date` string, required
  - `return_date` string, nullable, required
  - `price` number, required
  - `currency` string, required
  - `flight` string, required
  - `price_level` string, nullable, required
  - `typical_price_range` number[], nullable, required
  - `expires_at` string, date-time, required

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