---
title: "Sandbox: parse-query — stub response, same schema"
method: POST
path: "/sandbox/flights/parse-query"
tags: ["sandbox"]
---

# Sandbox: parse-query — stub response, same schema

`POST /sandbox/flights/parse-query`

## Request

- Base URL: `https://letsfg.co/developers/api/v1`
- URL: `https://letsfg.co/developers/api/v1/sandbox/flights/parse-query`
- Auth: API key in header `X-API-Key`

Returns a stub parse result to verify your request/response wiring. Use the production POST /flights/parse-query for real Gemini NL parsing.

## Request body

- ParseQueryRequest
  - `query` string, required: Natural language flight query.
  - `today` string, date: Override today's date (YYYY-MM-DD). Defaults to server date.
  - `mode` 'full' | 'clarify': full = parse everything; clarify = return only missing fields.

## Response `200`

Stub parse result with _sandbox flag.

- ParseQueryResponse
  - `origin` string, nullable: Resolved origin IATA code.
  - `destination` string, nullable: Resolved destination IATA code.
  - `departure_date` string, date, nullable
  - `return_date` string, date, nullable
  - `adults` integer, nullable
  - `depart_after` string, nullable: Earliest departure HH:MM (24h).
  - `depart_before` string, nullable: Latest departure HH:MM (24h).
  - `cabin_class` string, nullable
  - `follow_up_topics` string[]: Fields still missing from the query.
  - `follow_up_questions` object[]
  - `date_is_flexible` boolean

---

[API](https://skmtc.dev/letsfg/apis/letsfg-public-developer-api.md) · [All operations](https://skmtc.dev/letsfg/apis/letsfg-public-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsfg/apis/letsfg-public-developer-api/revisions/516ab6ba1d2e?raw)