---
title: "Reference data and key state"
method: GET
path: "/api/v1/travel/meta"
tags: ["Quotes"]
---

# Reference data and key state

`GET /api/v1/travel/meta`

## Request

- Base URL: `https://atlas.hellosafe.com`
- URL: `https://atlas.hellosafe.com/api/v1/travel/meta`
- Auth: API key in header `x-atlas-key-id` and API key in header `x-atlas-timestamp` and API key in header `x-atlas-signature`

The vocabulary a caller would otherwise hard-code: the 15 trip types, the 26 funnel languages, the 51 US state codes a US resident's stateResidence accepts, the guarantee slugs with their English labels and groups, the guarantee states a response can carry, the request ceilings, and your key's own environment and quota. Does not consume quota.

## Response `200`

Reference data.

- MetaResponse
  - `ok` boolean
  - `apiVersion` string
  - `key` object
    - `keyId` string
    - `mode` 'sandbox' | 'live'
    - `scopes` string[]
    - `quota` object
    - `lifetime` object
  - `trip` object
    - `intents` string[]
    - `languages` string[]
    - `usStates` string[]: The USPS codes stateResidence accepts: the 50 states and DC.
    - `maxTravellers` integer
    - `maxDestinations` integer
    - `notes` string[]
  - `guarantees` object[]
    - `slug` string
    - `label` string
    - `group` string
  - `states` object[]
    - `state` string
    - `meaning` string

## Other responses

- `401`: Missing, expired or invalid signature.
- `403`: The key does not carry the required scope.

---

[API](https://skmtc.dev/hellosafe/apis/hellosafe-travel-insurance-api.md) · [All operations](https://skmtc.dev/hellosafe/apis/hellosafe-travel-insurance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hellosafe/apis/hellosafe-travel-insurance-api/revisions/8185e81c9817?raw)