---
title: "Natural-language travel concierge — grounded itineraries with citations"
method: POST
path: "/v1/agent/concierge"
tags: ["agent"]
---

# Natural-language travel concierge — grounded itineraries with citations

`POST /v1/agent/concierge`

## Request

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

Send a natural-language travel query (any language script) and receive a structured, citation-bearing itinerary grounded in TravelMindsAI's data layer. The agent calls internal data tools (cities, circuits, heritage, restaurants, hotels, UNESCO) and composes a day-by-day plan. Counts as 1 quota call plus per-tool sub-calls.

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

- ConciergeOut
  - `version` string
  - `query` string, required
  - `language_detected` string, nullable
  - `summary` string
  - `itinerary` ItineraryDay[]
    - `day` integer, required
    - `city` CityRef
      - `id` string, nullable
      - `name` string, required
      - `iso_alpha2` string, nullable
      - `state_code` string, nullable
    - `title` string, nullable
    - `anchor` AnchorExperience: Best-in-class itinerary doctrine: each day is built around ONE titled hero moment with explicit significance. Optional — populated when the day has a clear anchor; absent for pure transfer/leisure days.
      - `name` string, required
      - `why_it_matters` string, nullable
      - `best_time` string, nullable
    - `pace` string, nullable
    - `morning` ItineraryItem[]
      - `item` string, required
      - `category` string, nullable
      - `duration_min` integer, nullable
      - `timings` string, nullable
      - `fee` string, nullable
      - `citation` string, nullable
    - `afternoon` ItineraryItem[]
      - `item` string, required
      - `category` string, nullable
      - `duration_min` integer, nullable
      - `timings` string, nullable
      - `fee` string, nullable
      - `citation` string, nullable
    - `evening` ItineraryItem[]
      - `item` string, required
      - `category` string, nullable
      - `duration_min` integer, nullable
      - `timings` string, nullable
      - `fee` string, nullable
      - `citation` string, nullable
    - `items` ItineraryItem[]
      - `item` string, required
      - `category` string, nullable
      - `duration_min` integer, nullable
      - `timings` string, nullable
      - `fee` string, nullable
      - `citation` string, nullable
    - `stay` object, nullable
    - `transit_in` object, nullable
  - `restaurants_recommended` RestaurantRecommended[]
    - `city_id` string, nullable
    - `name` string, required
    - `michelin_tier` string, nullable
    - `citation` string, nullable
  - `heritage_highlights` HeritageHighlight[]
    - `name` string, required
    - `type` string, nullable
    - `citation` string, nullable
  - `coverage_notes` string, nullable
  - `citations` CitationsBlock
    - `tool_calls` object[]
    - `data_sources` string[]
    - `attribution_lines` string[]
    - `ground_truth_refs` string[]
  - `partial` boolean
  - `degraded_reason` string, nullable
  - `tokens_used` TokensUsed
    - `input` integer
    - `output` integer
    - `cache_read` integer
    - `cache_create` integer
  - `tool_calls_made` integer
  - `elapsed_ms` integer
  - `layout_hint` string

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