{
  "name": "SimPig",
  "description": "Travel eSIMs bought without an account. This document only points: it changes nothing and needs no key.",
  "site": "https://simpig.com",
  "currency": "AUD",
  "guide": "https://simpig.com/agents.md",
  "read": {
    "storefront": {
      "method": "GET",
      "url": "https://simpig.com/",
      "type": "text/html",
      "freshness": "cached",
      "what": "The shop. Every page is complete without JavaScript; `Accept: text/markdown` returns Markdown."
    },
    "destinationsPage": {
      "method": "GET",
      "url": "https://simpig.com/buy",
      "type": "text/html",
      "freshness": "cached",
      "what": "Every country and region, with its cheapest plan. `?q=` searches."
    },
    "destinationPage": {
      "method": "GET",
      "url": "https://simpig.com/buy/{destination}",
      "type": "text/html",
      "freshness": "cached",
      "what": "A place's plans and prices, with each plan as an Offer in the page's JSON-LD."
    },
    "planPage": {
      "method": "GET",
      "url": "https://simpig.com/buy/{destination}/{plan}",
      "type": "text/html",
      "freshness": "cached",
      "what": "One plan. The page is its checkout: give a person this address and they pay there."
    },
    "tripPage": {
      "method": "GET",
      "url": "https://simpig.com/buy/trip?to={codes}",
      "type": "text/html",
      "freshness": "live",
      "what": "Several countries (two-letter codes, commas): the plan that covers them all, or the cheapest per country."
    },
    "catalogue": {
      "method": "GET",
      "url": "https://simpig.com/catalog.json",
      "type": "application/json",
      "freshness": "cached",
      "what": "Every place and plan in one read, with prices. For finding a plan; confirm before quoting."
    },
    "sitemap": {
      "method": "GET",
      "url": "https://simpig.com/sitemap.xml",
      "type": "application/xml",
      "freshness": "cached",
      "what": "Every public page."
    },
    "destinations": {
      "method": "GET",
      "url": "https://simpig.com/api/v1/catalog/destinations",
      "type": "application/json",
      "freshness": "live",
      "what": "Every place on sale with its plan count and \"from\" price."
    },
    "plans": {
      "method": "GET",
      "url": "https://simpig.com/api/v1/catalog/plans/{destination}",
      "type": "application/json",
      "freshness": "live",
      "what": "A place's plans, the regional plans that cover it included: networks, top-ups, coverage."
    },
    "plan": {
      "method": "GET",
      "url": "https://simpig.com/api/v1/catalog/plan/{productId}",
      "type": "application/json",
      "freshness": "live",
      "what": "One plan as it is on sale now. The authority for its price before an order."
    },
    "trip": {
      "method": "GET",
      "url": "https://simpig.com/api/v1/catalog/trip?to={codes}",
      "type": "application/json",
      "freshness": "live",
      "what": "Plans covering every country of a trip, and each country's own."
    },
    "status": {
      "method": "GET",
      "url": "https://simpig.com/api/v1/status",
      "type": "application/json",
      "freshness": "live",
      "what": "Whether the shop, payments, delivery and the agent endpoints work right now."
    },
    "orderWatch": {
      "method": "GET",
      "url": "https://simpig.com/api/v1/agent/watch/{key}",
      "type": "application/json",
      "freshness": "live",
      "what": "Where an order started from a plan page you shared has got to: the status only. Put `?watch={key}` (16 to 64 random URL-safe characters you make up) on the plan page address first."
    },
    "openapi": {
      "method": "GET",
      "url": "https://simpig.com/api/v1/openapi.json",
      "type": "application/vnd.oai.openapi+json",
      "freshness": "static",
      "what": "The whole API."
    },
    "agentGuide": {
      "method": "GET",
      "url": "https://simpig.com/agents.md",
      "type": "text/markdown",
      "freshness": "static",
      "what": "How to buy for someone, step by step."
    },
    "llms": {
      "method": "GET",
      "url": "https://simpig.com/llms.txt",
      "type": "text/markdown",
      "freshness": "static",
      "what": "The short index; /llms-full.txt is the long form."
    },
    "apiCatalog": {
      "method": "GET",
      "url": "https://simpig.com/.well-known/api-catalog",
      "type": "application/linkset+json",
      "freshness": "static",
      "what": "The APIs as an RFC 9727 linkset."
    }
  },
  "act": {
    "startOrder": {
      "method": "POST",
      "url": "https://simpig.com/api/v1/agent/orders",
      "type": "application/json",
      "freshness": "live",
      "what": "Start an order for a person's email and a productId. Validated and priced by the shop at that moment; answers with a pay link for the person. No key."
    },
    "orderStatus": {
      "method": "GET",
      "url": "https://simpig.com/api/v1/agent/orders/{ref}",
      "type": "application/json",
      "freshness": "live",
      "what": "The order and, once fulfilled, the install details. Needs the order token returned when the order started."
    },
    "mcp": {
      "method": "POST",
      "url": "https://simpig.com/api/mcp",
      "type": "application/json",
      "freshness": "live",
      "what": "The same reads and the order as Model Context Protocol tools (Streamable HTTP)."
    },
    "a2a": {
      "method": "POST",
      "url": "https://simpig.com/api/a2a",
      "type": "application/json",
      "freshness": "live",
      "what": "The same as an Agent2Agent endpoint; its card is at /.well-known/agent-card.json."
    }
  },
  "rules": [
    "Find a plan from any read. Before telling a person a final price, read it live (read.plan), or start the order and show the total it returns.",
    "An order is validated when it starts: a plan no longer on sale answers 422, whatever a cached copy said.",
    "If you can only GET: give the person the plan page (read.planPage). They enter an email and pay there. Add `?watch={key}` to it and read read.orderWatch to learn when it is paid.",
    "Buying needs no account. Never ask a person for a password."
  ]
}