UT Division of Oil, Gas and Mining

Methods (5)

• searchWells

  read

  UT surface wells (~40K). Filter operator/county/wellStatus/wellType/bbox/near.

  Entitieswell
  Input schema

  {
    "type": "object",
    "properties": {
      "api": {
        "type": "string"
      },
      "operator": {
        "type": "string"
      },
      "fieldName": {
        "type": "string"
      },
      "wellStatus": {
        "type": "string",
        "examples": [
          "P"
        ]
      },
      "wellType": {
        "type": "string"
      },
      "leaseType": {
        "type": "string"
      },
      "producingOnly": {
        "type": "boolean"
      },
      "county": {
        "type": "string",
        "examples": [
          "Duchesne"
        ]
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "near": {
        "type": "object",
        "properties": {
          "lat": {
            "type": "number"
          },
          "lon": {
            "type": "number"
          },
          "radiusMiles": {
            "type": "number"
          }
        },
        "required": [
          "lat",
          "lon",
          "radiusMiles"
        ],
        "additionalProperties": false
      },
      "limit": {
        "type": "number"
      },
      "format": {
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "records"
            ]
          },
          {
            "type": "string",
            "enum": [
              "geojson"
            ]
          }
        ]
      }
    },
    "additionalProperties": false
  }

  County stored UPPERCASE ("DUCHESNE","SAN JUAN"). 15 status codes, 20 type codes.

• getWellByApi

  read

  Single-well lookup by 10-digit API. Returns the surface-well record.

  Required paramsapi

  Entitieswell
  Input schema

  {
    "type": "object",
    "properties": {
      "api": {
        "type": "string",
        "examples": [
          "4301330032"
        ]
      },
      "apiNumber": {
        "type": "string"
      },
      "api_number": {
        "type": "string"
      }
    },
    "additionalProperties": false,
    "required": [
      "api"
    ]
  }

• searchBottomHoles

  read

  UT bottomhole locations (~33K). Deviated wells. Filter constructType/county/deviatedOnly.

  Entitiestrajectory, well
  Input schema

  {
    "type": "object",
    "properties": {
      "api": {
        "type": "string"
      },
      "constructType": {
        "type": "string"
      },
      "constructStatus": {
        "type": "string"
      },
      "deviatedOnly": {
        "type": "boolean",
        "examples": [
          true
        ]
      },
      "county": {
        "type": "string",
        "examples": [
          "Uintah"
        ]
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "near": {
        "type": "object",
        "properties": {
          "lat": {
            "type": "number"
          },
          "lon": {
            "type": "number"
          },
          "radiusMiles": {
            "type": "number"
          }
        },
        "required": [
          "lat",
          "lon",
          "radiusMiles"
        ],
        "additionalProperties": false
      },
      "limit": {
        "type": "number"
      },
      "format": {
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "records"
            ]
          },
          {
            "type": "string",
            "enum": [
              "geojson"
            ]
          }
        ]
      }
    },
    "additionalProperties": false
  }

  County is integer code on this layer; handler translates from county name.

• searchWellPaths

  read

  UT directional well-path polylines (~12.5K). Filter api/constructStatus/bbox/near.

  Entitiestrajectory, well
  Input schema

  {
    "type": "object",
    "properties": {
      "api": {
        "type": "string"
      },
      "constructStatus": {
        "type": "string"
      },
      "county": {
        "type": "string"
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "near": {
        "type": "object",
        "properties": {
          "lat": {
            "type": "number"
          },
          "lon": {
            "type": "number"
          },
          "radiusMiles": {
            "type": "number"
          }
        },
        "required": [
          "lat",
          "lon",
          "radiusMiles"
        ],
        "additionalProperties": false
      },
      "limit": {
        "type": "number"
      },
      "format": {
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "records"
            ]
          },
          {
            "type": "string",
            "enum": [
              "geojson"
            ]
          }
        ]
      }
    },
    "additionalProperties": false
  }

  No county/operator/wellName upstream — join via API to searchWells.

• getServiceInfo

  read

  Schema + record counts for any of 3 services (UT Division of Oil, Gas and Mining).

  Entitiesmetadata
  Input schema

  {
    "type": "object",
    "properties": {
      "service": {
        "type": "string",
        "examples": [
          "wells-surf"
        ],
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "wells-surf"
            ]
          },
          {
            "type": "string",
            "enum": [
              "wells-downhole"
            ]
          },
          {
            "type": "string",
            "enum": [
              "wells-paths"
            ]
          }
        ]
      }
    },
    "additionalProperties": false
  }