---
title: "Hotels for a city, ranked by rating then curation richness"
method: GET
path: "/v1/hotels"
tags: ["data"]
---

# Hotels for a city, ranked by rating then curation richness

`GET /v1/hotels`

## Request

- Base URL: `https://api.travelminds.ai`
- URL: `https://api.travelminds.ai/v1/hotels`
- Auth: none declared

Ordering: rating DESC > metadata.rating DESC > quality_class > presence of curation flags (notable_for, style, booking_url) > data_quality. Megacity rollup applies to city_id queries (e.g. New York City returns hotels from all NYC boroughs).

## Query parameters

- `city_id` string, nullable
- `iso_alpha2` string, nullable
- `limit` integer
- `offset` integer

## Headers

- `authorization` string, nullable
- `x-rapidapi-proxy-secret` string, nullable
- `x-rapidapi-user` string, nullable
- `x-tmai-proxy-secret` string, nullable
- `x-tmai-proxy-provider` string, nullable
- `x-tmai-proxy-user` string, nullable

## Response `200`

Successful Response

- LodgingOut[]
  - `id` string, required: Canonical hotel / restaurant / experience UUID.
  - `name` string, required: Venue name.
  - `city_id` string, required: Parent city UUID. Megacity rollup applies on city_id queries.
  - `city_name` string, nullable: Parent city name (denormalised).
  - `iso_alpha2` string, nullable: Country code of the parent city.
  - `rating` string, nullable: Source-provided rating (string-typed; precision varies).
  - `source` string, nullable: Upstream data source (e.g. 'michelin', 'booking', 'foursquare').
  - `license` string, nullable: License id from the registry.
  - `license_url` string, nullable: Public URL of the license text.
  - `attribution_required` boolean, nullable: True if downstream use must cite the upstream source.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway.md) · [All operations](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway/revisions/d05c8634e340?raw)