GetMyHotels Flights API
The flights API from GetMyHotels — 1 operation(s) for flights.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/getmyhotels-com:getmyhotels-com-flights-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: GetMyHotels REST Flights API
version: 1.0.0
description: REST surface for the native GetMyHotels apps. Every route is a thin transport over the shared tRPC routers — inputs are validated with the same Zod schemas the web client uses, and responses are returned verbatim. Authentication uses Better Auth bearer session tokens issued by the /api/auth/* endpoints (not part of this spec). Native clients send X-GMH-App-Version and X-GMH-Platform on every request; versions below the configured floor receive a typed 426 UpgradeRequiredError.
servers:
- url: https://api.getmyhotels.com
description: Production API
tags:
- name: Flights
paths:
/v1/flights/search:
post:
tags:
- Flights
summary: Search flights (retired)
description: 'Flights are no longer offered. Kept so iOS and Android builds already in the stores keep decoding: always returns 200 with an empty result set, `health.flights = "skipped"` and an informational diagnostic, and never calls a supplier.'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
origin:
type: string
minLength: 1
maxLength: 10
destination:
type: string
minLength: 1
maxLength: 10
departureDate:
type: string
pattern: ^\d{4}-\d{2}-\d{2}$
returnDate:
type: string
pattern: ^\d{4}-\d{2}-\d{2}$
routeType:
type: string
enum:
- oneway
- return
default: oneway
cabinType:
type: string
enum:
- economy
- business
- first
default: economy
adults:
type: integer
minimum: 1
maximum: 9
default: 1
children:
type: integer
minimum: 0
maximum: 9
default: 0
infants:
type: integer
minimum: 0
maximum: 9
default: 0
page:
type: integer
minimum: 1
default: 1
limit:
type: integer
minimum: 1
maximum: 50
default: 20
sortBy:
type: string
enum:
- price
- duration
airline:
type: string
minLength: 1
maxLength: 100
stops:
type: string
enum:
- non_stop
- one_stop
- two_plus
nonstop:
type: boolean
required:
- origin
- destination
- departureDate
responses:
'200':
description: Success
content:
application/json:
schema:
description: Verbatim JSON output of the `flight.searchFlights` tRPC procedure. Response shapes are intentionally not modeled in this spec; the native client types them by hand.
'400':
description: Request validation failed or the router rejected the input
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'426':
description: Reported X-GMH-App-Version is below the supported minimum — the app must update
content:
application/json:
schema:
$ref: '#/components/schemas/UpgradeRequiredError'
'500':
description: Unexpected server error (opaque; details stay in logs)
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
operationId: postV1FlightsSearch
x-operation-id-source: derived
components:
schemas:
UpgradeRequiredError:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- UPGRADE_REQUIRED
message:
type: string
minVersion:
type: string
example: 1.2.0
platform:
type:
- string
- 'null'
required:
- code
- message
- minVersion
- platform
required:
- error
ApiError:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: NOT_FOUND
message:
type: string
example: Booking not found
domainCode:
type: string
example: NON_REFUNDABLE_CONSENT_REQUIRED
issues:
type: array
items:
type: object
properties:
path:
type: string
message:
type: string
required:
- path
- message
required:
- code
- message
required:
- error
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Better Auth session token. Obtain it from the native /api/auth/* endpoints (Better Auth bearer plugin — out of scope for this spec, see #922).'
x-provenance:
method: harvested
publisher: GetMyHotels
source: https://api.getmyhotels.com/v1/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)