---
title: "Full composite-score row for a city: master + sub-scores + derived indices"
method: GET
path: "/v1/scores/{city_id}"
tags: ["data"]
---

# Full composite-score row for a city: master + sub-scores + derived indices

`GET /v1/scores/{city_id}`

## Request

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

Returns master_score, social/connectivity/NPS/value sub-scores, dimensions_scored, and the seven derived indices (family / luxury / adventure / retirement / weekend-getaway / overtourism-risk / best-fit). Length 0 if the city has no score row.

## Path parameters

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

- ScoreOut[]
  - `city_id` string, required: City UUID this score row applies to.
  - `name` string, required: City name.
  - `iso_alpha2` string, nullable: Country code.
  - `master_score` string, nullable: Composite master score (0-1, 2dp).
  - `tier` string, nullable: Internal tier classification.
  - `social_sub` string, nullable: Social/travel-buzz sub-score.
  - `connectivity_sub` string, nullable: Connectivity (air/rail/road) sub-score.
  - `nps_sub` string, nullable: Net-promoter style sub-score from review aggregates.
  - `value_index` string, nullable: Cost-vs-quality value index.
  - `dimensions_scored` integer, nullable: Number of input dimensions used to compute this score.
  - `rising_star` string, nullable: Rising-star momentum signal.
  - `family_travel` string, nullable: Family-travel suitability index.
  - `luxury_index` string, nullable: Luxury-travel suitability index.
  - `adventure_travel` string, nullable: Adventure-travel suitability index.
  - `retirement_expat` string, nullable: Retirement / long-term expat suitability.
  - `weekend_getaway` string, nullable: Short-trip / weekend-getaway suitability.
  - `overtourism_risk` string, nullable: Overtourism risk index (higher = more crowded).
  - `best_fit` string, nullable: Best-fit traveler-persona label (free-form short string).
  - `indices_scored` integer, nullable: Number of derived indices populated for this row.

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