Roami — Agent & API Documentation

This page documents the machine-readable endpoints that AI agents and crawlers can use to discover, read, and compare Roami travel eSIM products across 200+ destinations.

Endpoints

Endpoint	Purpose
`/catalog.json`	Complete product catalog — every country, every plan, with data amount, validity, and price.
`/llms.txt`	LLM-friendly overview: coverage, pricing tiers, key pages, and popular destinations.
`/sitemap.xml`	Standard sitemap of all pages.
`/openapi.json`	OpenAPI spec describing the catalog endpoint.
`/.well-known/api-catalog`	RFC 9727 linkset pointing to the API description and docs.
`/.well-known/ai-catalog.json`	ARD (Agent Resource Discovery) manifest of discoverable resources.
`/.well-known/agent-skills/index.json`	Agent skills discovery index.

`/catalog.json` schema

The catalog is a JSON document (valid JSON-LD, @type: ItemList) with the following top-level fields:

{
  "@type": "ItemList",
  "brand": "Roami",
  "currency": "USD",
  "itemCount": 164,
  "countries": [ { ... } ]
}

Each entry in countries:

{
  "name": "Japan eSIM",
  "url": "https://www.roamiapp.com/japan-esim/",
  "operators": ["NTT Docomo", "SoftBank", "KDDI"],
  "cities": ["Tokyo", "Osaka", "Kyoto"],
  "lowPriceUSD": 1.99,
  "highPriceUSD": 39.9,
  "plans": [
    {
      "validityDays": 3,
      "validityLabel": "3 Days",
      "dataAmount": "1GB",
      "network": "High-Speed 5G/4G/LTE",
      "priceUSD": "1.99",
      "oldPriceUSD": "2.98",
      "dailyUSD": "0.66"
    }
  ]
}

Field reference

Field	Type	Meaning
`validityDays`	number	Plan validity in days (3, 7, 10, 15, 30, 180).
`dataAmount`	string	Included data, e.g. `1GB`, `5GB`, or `Unlimited`.
`priceUSD`	string	Price in USD (before any discount code).
`oldPriceUSD`	string	List price before discount.
`dailyUSD`	string	Effective cost per day.

How agents should use this

Discovery: read /llms.txt or the Link response headers for entry points.
Comparison: fetch /catalog.json once and filter/sort countries[].plans[] by validityDays and priceUSD to find the cheapest plan for a destination.
Citation: link back to the country url for humans.

Access