Voyant Data

Voyant Data is the data layer of the platform. It bundles the reference and enrichment data that travel apps constantly need behind a single typed client and a single API token. Instead of integrating a separate vendor for airports, another for exchange rates, and another for reviews, you call them all through @voyant-travel/data-sdk. The Data product is served behind the public gateway at https://api.voyant.travel/data/{product}/v1/*. Each one is a top-level namespace on the client.

The data products

Geo

Canonical travel geography: countries, regions, cities, ports, and waterways, plus language and timezone lookups.

Air

Aviation reference data: airports, airlines, and aircraft.

FX

Currency exchange rates and the ISO 4217 currency catalog.

Business data

Reviews, hotels, restaurants, and experiences from Google and TripAdvisor.

Install and call

pnpm add @voyant-travel/data-sdk

import { createVoyantDataClient } from "@voyant-travel/data-sdk";

const client = createVoyantDataClient({
  apiKey: process.env.VOYANT_API_KEY!,
});

const countries = await client.geo.countries.list();
const lhr = await client.air.airports.get("LHR");
const eurUsd = await client.fx.pair("EUR", "USD", 100);

Response envelopes

The Data SDK preserves the API envelopes so you never lose pagination metadata:

List and search methods return ListResponse<T>, shaped { data, totalCount, nextCursor? }.
Single-item methods return SingleResponse<T>, shaped { data }.

Paginate by passing nextCursor back on the next call.

Authentication and scopes

Authentication is a Voyant API token as a bearer token against https://api.voyant.travel. Tokens are scoped per sub-product:

Namespace	Scope
`client.geo.*`	`data:geo:read`
`client.air.*`	`data:air:read`
`client.fx.*`	`data:fx:read`
`client.reviews.*`	`data:reviews:read`
`client.hotels.*`	`data:hotels:read`
`client.restaurants.*`	`data:restaurants:read`
`client.experiences.*`	`data:experiences:read`

See Authentication for how tokens and scopes work across the SDKs.

Errors

Non-2xx responses throw VoyantApiError with status, requestId, and body. The Data API also returns a stable code on its error bodies, typed as DataErrorCode: NOT_FOUND, INVALID_REQUEST, INVALID_CURSOR, UPSTREAM_FAILED, INTERNAL_AUTH_REQUIRED, and RATE_LIMITED. See Errors and transport.

Data

Products

API reference

The data products

Geo

Air

FX

Business data

Install and call

Response envelopes

Authentication and scopes

Errors

​The data products

Geo

Air

FX

Business data

​Install and call

​Response envelopes

​Authentication and scopes

​Errors

The data products

Install and call

Response envelopes

Authentication and scopes

Errors