{
  "openapi": "3.1.0",
  "info": {
    "title": "Berlin Royalties public data API",
    "version": "1.0.0",
    "description": "Free, open data for oil and gas mineral and royalty owners: state-registered operators, royalty payment law by state, well record lookup tools, and a plain-English glossary. Published by Berlin Royalties, a veteran-owned mineral buyer in Tulsa, Oklahoma. No key and no rate limit. Free to use and cite with attribution.",
    "contact": {"name": "Berlin Royalties", "url": "https://www.berlinroyalties.com"},
    "license": {"name": "CC BY 4.0", "url": "https://creativecommons.org/licenses/by/4.0/"}
  },
  "servers": [{"url": "https://www.berlinroyalties.com"}],
  "paths": {
    "/api/v1/index.json": {
      "get": {
        "summary": "Discovery document listing every endpoint, its record count, and its source",
        "operationId": "getIndex",
        "responses": {"200": {"description": "OK", "content": {"application/json": {}}}}
      }
    },
    "/api/v1/operators/{state}.json": {
      "get": {
        "summary": "Oil and gas operators registered with a state regulator",
        "description": "Operator name, regulator-issued ID, mailing address, phone, and registered contact where the agency publishes one. Refreshed weekly from the source agency. Useful for finding who to call about a royalty check or a well.",
        "operationId": "getOperatorsByState",
        "parameters": [{
          "name": "state", "in": "path", "required": true,
          "description": "State slug",
          "schema": {"type": "string", "enum": ["oklahoma", "texas", "kansas", "wyoming", "colorado"]}
        }],
        "responses": {"200": {"description": "OK", "content": {"application/json": {}}}, "404": {"description": "State not covered"}}
      }
    },
    "/api/v1/royalty-laws.json": {
      "get": {
        "summary": "Royalty payment law by state",
        "description": "Statutory first-payment and ongoing payment deadlines, late-payment interest rates, minimum payment thresholds, limitation periods, and forced pooling authority, each with its statute citation. Verified against statutory text rather than secondary summaries. General information, not legal advice.",
        "operationId": "getRoyaltyLaws",
        "responses": {"200": {"description": "OK", "content": {"application/json": {}}}}
      }
    },
    "/api/v1/well-records.json": {
      "get": {
        "summary": "Free well record lookup tools by state",
        "description": "Verified direct links to each state's well search, production data, map viewer, and scanned records, with the quirks of each system explained.",
        "operationId": "getWellRecords",
        "responses": {"200": {"description": "OK", "content": {"application/json": {}}}}
      }
    },
    "/api/v1/glossary.json": {
      "get": {
        "summary": "Plain-English glossary of mineral ownership terms",
        "operationId": "getGlossary",
        "responses": {"200": {"description": "OK", "content": {"application/json": {}}}}
      }
    }
  }
}