{
  "openapi": "3.1.0",
  "info": {
    "title": "American Royalty Buyers API",
    "version": "1.0.0",
    "description": "Read-only JSON describing American Royalty Buyers, a direct buyer of Permian Basin and U.S. mineral rights, royalties, and working interests.",
    "contact": {
      "email": "offer@americanroyaltybuyers.com",
      "url": "https://www.americanroyaltybuyers.com"
    }
  },
  "servers": [
    {
      "url": "https://www.americanroyaltybuyers.com"
    }
  ],
  "paths": {
    "/api/company": {
      "get": {
        "summary": "Company profile and acquisition criteria",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/basins": {
      "get": {
        "summary": "List all oil & gas basins where ARB buys",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/basins/{slug}": {
      "get": {
        "summary": "Detailed basin profile",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/states": {
      "get": {
        "summary": "List all states where ARB buys",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/states/{stateSlug}/counties": {
      "get": {
        "summary": "List counties ARB covers in a state",
        "parameters": [
          {
            "name": "stateSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/states/{stateSlug}/counties/{countySlug}": {
      "get": {
        "summary": "County profile",
        "parameters": [
          {
            "name": "stateSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "countySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/resources": {
      "get": {
        "summary": "List educational guides for mineral owners",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/resources/{slug}": {
      "get": {
        "summary": "Full text of an educational guide",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/permian-stats": {
      "get": {
        "summary": "Dated Permian Basin activity statistics — rigs, permits, prices (quarterly)",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/operators": {
      "get": {
        "summary": "Dated list of the most active Permian operators by drilling permits, with royalty-check payor names (quarterly)",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/operators/{slug}": {
      "get": {
        "summary": "Operator profile — permitting activity by county and check-stub names",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/counties": {
      "get": {
        "summary": "Flat index of all county coverage with basin mapping and enrichment flag",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    }
  }
}