---
title: "The fact dictionary and every verified fact in a market"
method: GET
path: "/agents/hotels/{market}/facts.json"
---

# The fact dictionary and every verified fact in a market

`GET /agents/hotels/{market}/facts.json`

## Request

- Base URL: `https://journeyed.org`
- URL: `https://journeyed.org/agents/hotels/{market}/facts.json`
- Auth: none declared

keys lists every fact key with its meaning, kind, unit and allowed values. hotels lists every hotel with a verified fact beyond contact details, one per line, each fact with its source and checked date. A key missing from a hotel is unknown, not absent.

## Path parameters

- `market` string, required

## Response `200`

The fact dictionary and every verified fact in a market

- FactIndex: The fact dictionary and compact fact index of one market (/agents/<category>/<market>/facts.json): every fact key that can exist, and every hotel with at least one verified fact, one per line. A key missing from a hotel is unknown, not absent.
  - `schemaVersion` 1, required
  - `type` 'fact-index', required
  - `jsonUrl` string, uri, required
  - `asOf` string, date, required
  - `publisher` Publisher, required: The publisher. disclosure and parent are present only when the publisher has a parent company.
    - `name` string, required
    - `disclosure` string
    - `parent` string
  - `market` string, required
  - `description` string, required
  - `placesUrl` string, uri, required
  - `anchorsUrl` string, uri, required
  - `valueKinds` object, required
  - `groups` object[], required
    - `id` string, required
    - `label` string, required
  - `keys` FactIndexKey[], required
    - `key` string, required
    - `label` string, required
    - `group` string, required
    - `kind` string, required
    - `unit` string, nullable, required
    - `values` object[], nullable, required
      - `value` string, required
      - `label` string, required
    - `hotels` integer, required
  - `hotelsInMarket` integer, required
  - `count` integer, required
  - `hotels` FactIndexHotel[], required
    - `placeId` string, required
    - `name` string, required
    - `url` string, uri, required
    - `jsonUrl` string, uri, required
    - `sources` array[], required
      - string[]: [page URL or dataset id, checked date]
    - `facts` object, required: fact key -> [stored value, index into sources]

## Other responses

- `404`: No such page. Twins are not redirected: when a page moved or a question fell below the publish threshold, its HTML URL redirects but its .json and .md twins return 404, so re-read answers.json.

---

[API](https://skmtc.dev/journeyed/apis/journeyed-answers.md) · [All operations](https://skmtc.dev/journeyed/apis/journeyed-answers/llms.txt) · [OpenAPI document](https://skmtc.dev/journeyed/apis/journeyed-answers/revisions/16020bee9761?raw)