> ## Documentation Index > Fetch the complete documentation index at: https://voyant.travel/docs/llms.txt > Use this file to discover all available pages before exploring further. # List places related to a place > Return places related to a place via a relation kind (flows_through, borders, part_of, near). Requires scope `data:geo:read`. ## OpenAPI ````yaml /api-specs/data.json get /data/geo/v1/places/{id}/related openapi: 3.1.0 info: title: Voyant Data API version: 1.0.0 description: >- Public REST API for the Voyant Data product. Voyant Data is a set of Cloudflare Workers served behind the public gateway at https://api.voyant.travel. Each sub-product worker mounts internally at /v1/... and is exposed publicly under /data/{product}/v1/*. Sub-products: geo, air, fx, reviews, hotels, restaurants, experiences. Authentication is a bearer API token scoped per sub-product (data:{product}:read). List/search endpoints return { data, totalCount, nextCursor? }; single-item endpoints return { data }. Error bodies carry a stable code (NOT_FOUND, INVALID_REQUEST, INVALID_CURSOR, UPSTREAM_FAILED, INTERNAL_AUTH_REQUIRED, RATE_LIMITED). servers: - url: https://api.voyant.travel description: Voyant Data public gateway security: - bearerAuth: [] tags: - name: Geo description: >- Canonical travel geography (countries, regions, cities, ports, waterways) plus language and timezone reference lookups. Scope: data:geo:read - name: Air description: >- Aviation reference data: airports, airlines, aircraft. Scope: data:air:read - name: FX description: >- Currency exchange (exchangerate-api.com white-label) plus the ISO 4217 currency catalog. Scope: data:fx:read - name: Reviews description: >- Google Reviews / Extended Reviews / Q&A and Trustpilot. Scope: data:reviews:read - name: Hotels description: 'Google Hotels and TripAdvisor (hotel-scoped). Scope: data:hotels:read' - name: Restaurants description: 'TripAdvisor restaurants. Scope: data:restaurants:read' - name: Experiences description: 'TripAdvisor attractions / experiences. Scope: data:experiences:read' paths: /data/geo/v1/places/{id}/related: get: tags: - Geo summary: List places related to a place description: >- Return places related to a place via a relation kind (flows_through, borders, part_of, near). Requires scope `data:geo:read`. operationId: geoGetPlaceRelated parameters: - name: id in: path required: true schema: type: string example: Q1644 - name: relation in: query required: false schema: $ref: '#/components/schemas/PlaceRelationKind' example: flows_through - name: direction in: query required: false schema: type: string enum: - outgoing - incoming example: outgoing - name: type in: query required: false schema: $ref: '#/components/schemas/CanonicalPlaceType' example: country - name: lang in: query required: false schema: type: string example: en - name: names in: query required: false schema: type: boolean example: false responses: '200': description: Related places content: application/json: schema: $ref: '#/components/schemas/CanonicalPlaceListResponse' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' x-codeSamples: - lang: typescript label: SDK source: >- import { createVoyantDataClient } from "@voyant-travel/data-sdk"; const data = createVoyantDataClient({ apiKey: process.env.VOYANT_API_KEY }); const result = await data.geo.places.related(""); - lang: bash label: cURL source: |- curl --request GET \ --url https://api.voyant.travel/data/geo/v1/places//related \ --header 'Authorization: Bearer ' - lang: javascript label: Node source: >- const response = await fetch("https://api.voyant.travel/data/geo/v1/places//related", { method: "GET", headers: { "Authorization": "Bearer " }, }); const data = await response.json(); - lang: python label: Python source: |- import requests response = requests.get( "https://api.voyant.travel/data/geo/v1/places//related", headers={ "Authorization": "Bearer " } ) data = response.json() components: schemas: PlaceRelationKind: type: string enum: - flows_through - borders - part_of - near CanonicalPlaceType: type: string enum: - region - country - subdivision - city - port - river - sea - ocean - canal - lake CanonicalPlaceListResponse: type: object required: - data - totalCount properties: data: type: array items: $ref: '#/components/schemas/CanonicalPlace' totalCount: type: integer nextCursor: type: string CanonicalPlace: type: object required: - id - type properties: id: type: string description: >- Stable canonical id (ISO2 country, UN/LOCODE port, QID waterway, ...). type: $ref: '#/components/schemas/CanonicalPlaceType' unlocode: type: string description: UN/LOCODE if applicable (e.g. DEHAM); a ZZ prefix denotes at-sea. countryIso2: type: string parentId: type: string coordinates: $ref: '#/components/schemas/PlaceCoordinates' name: type: string description: Server-resolved display name for the requested language. nameLang: type: string names: type: object additionalProperties: type: string description: Locale -> display name map (omitted unless names=true). aliases: type: array items: type: string attributes: type: object additionalProperties: true Error: type: object required: - code properties: code: type: string enum: - NOT_FOUND - INVALID_REQUEST - INVALID_CURSOR - UPSTREAM_FAILED - INTERNAL_AUTH_REQUIRED - RATE_LIMITED description: Stable machine-readable error code. message: type: string description: Human-readable error detail. PlaceCoordinates: type: object required: - lat - lng properties: lat: type: number lng: type: number responses: Unauthorized: description: >- Missing or invalid bearer token / insufficient scope (code INTERNAL_AUTH_REQUIRED). content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: Resource not found (code NOT_FOUND). content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Voyant Data API token, scoped per sub-product (data:{product}:read). Sent as `Authorization: Bearer `. ````