{
  "name": "Berlin Royalties public data API",
  "version": "1",
  "description": "Free, open data for oil and gas mineral and royalty owners, published by Berlin Royalties, a veteran-owned mineral buyer in Tulsa, Oklahoma. No key, no rate limit, CORS enabled. Free to use and cite with attribution.",
  "publisher": {
    "name": "Berlin Royalties",
    "url": "https://www.berlinroyalties.com",
    "telephone": "918-984-1645",
    "legalName": "Berlin Resources LLC"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "Berlin Royalties, https://www.berlinroyalties.com",
  "openapi": "https://www.berlinroyalties.com/openapi.json",
  "llms_txt": "https://www.berlinroyalties.com/llms.txt",
  "endpoints": [
    {
      "path": "/api/v1/operators/{state}.json",
      "description": "Oil and gas operators registered with each state regulator: name, regulator ID, address, phone, and contact where the agency publishes it. Refreshed weekly from the source agency.",
      "states": ["oklahoma", "texas", "kansas", "wyoming", "colorado"],
      "records": 38003,
      "source": "State oil and gas regulators, normalized by Berlin Royalties"
    },
    {
      "path": "/api/v1/glossary.json",
      "description": "Plain-English definitions of oil and gas mineral ownership terms.",
      "records": 65
    },
    {
      "path": "/api/v1/royalty-laws.json",
      "description": "Statutory royalty payment deadlines, late-payment interest rates, minimum payment thresholds, limitation periods, and forced pooling authority, by state, each with its statute citation. Verified against statutory text.",
      "records": 10
    },
    {
      "path": "/api/v1/well-records.json",
      "description": "Verified direct links to every state's free well search, production data, map viewer, and scanned records, with the quirks of each system explained.",
      "records": 20
    }
  ],
  "notes": [
    "All responses are static JSON served from Cloudflare's edge. There is no authentication and no rate limit.",
    "Berlin Royalties is a mineral buyer, not a law firm. Statutory data is general information, not legal advice.",
    "Corrections are welcome: call or text 918-984-1645."
  ]
}