---
title: "Circuit detail with member cities in sequence order"
method: GET
path: "/v1/circuits/{slug}"
tags: ["data"]
---

# Circuit detail with member cities in sequence order

`GET /v1/circuits/{slug}`

## Request

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

Same fields as CircuitOut plus members[] in sequence_no order, each linked back to a TMAIV2 city UUID where possible (gives you the lat/lon and lets you fan out into other endpoints).

## Path parameters

- `slug` string, required

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

- CircuitDetailOut
  - `slug` string, required
  - `name` string, required
  - `description` string, nullable
  - `category` string, nullable
  - `ideal_duration_days` integer, nullable
  - `best_season` string, nullable
  - `scope` string, nullable
  - `members` CircuitMemberOut[], required
    - `sequence_no` integer, required
    - `city_name` string, required
    - `state_code` string, nullable
    - `country_iso2` string, nullable
    - `notes` string, nullable
    - `city_id` string, nullable
    - `latitude` string, nullable
    - `longitude` string, nullable

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