---
title: "List the canonical tourism circuits (India + global)"
method: GET
path: "/v1/circuits"
tags: ["data"]
---

# List the canonical tourism circuits (India + global)

`GET /v1/circuits`

## Request

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

34 named multi-city circuits: 17 across India (buddhist-circuit, golden-triangle, kerala-backwaters, ...) and 17 global (silk-road, camino-de-santiago, safari-trail, world-wine-trail, northern-lights, ...). Each row has slug, name, description, ideal_duration_days, best_season, the regions traversed (states[] for India, country codes for global), and scope ('india'|'global'). Filter with ?scope=india or ?scope=global.

## Query parameters

- `scope` 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

- CircuitOut[]
  - `slug` string, required: Kebab-case circuit identifier (e.g. 'buddhist-circuit').
  - `name` string, required: Human-readable circuit name.
  - `description` string, nullable: One-paragraph circuit description.
  - `category` string, nullable: Theme (e.g. 'spiritual', 'heritage', 'eco').
  - `ideal_duration_days` integer, nullable: Recommended trip length in days.
  - `best_season` string, nullable: Best season window (free-form).
  - `states` string[], nullable: Regions traversed: ISO-3166-2 state codes (India circuits) or ISO-3166-1 country codes (global circuits).
  - `cross_border` boolean, nullable: True if the circuit crosses an international border.
  - `scope` string, nullable: 'india' or 'global'.
  - `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)