NSTA UK — Offshore & Onshore

Methods (12)

• searchWells

  read

  Search UKCS offshore wells by operator, licence number, name, or bbox.

  Entitieswell
  Input schema

  {
    "type": "object",
    "properties": {
      "wellName": {
        "type": "string"
      },
      "operator": {
        "type": "string",
        "examples": [
          "Shell"
        ]
      },
      "licenceNumber": {
        "type": "string"
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "limit": {
        "type": "number",
        "examples": [
          50
        ]
      },
      "offset": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  Bottom-hole records. Use searchOnshoreWells for onshore/land wells.

• searchOnshoreWells

  read

  Search UK onshore petroleum wells by operator, county, status, licence, or bbox.

  Entitieswell
  Input schema

  {
    "type": "object",
    "properties": {
      "wellName": {
        "type": "string"
      },
      "wellRegNo": {
        "type": "string"
      },
      "operator": {
        "type": "string",
        "examples": [
          "BP"
        ]
      },
      "licenceNumber": {
        "type": "string"
      },
      "county": {
        "type": "string",
        "examples": [
          "East Sussex"
        ]
      },
      "operationStatus": {
        "type": "string"
      },
      "intent": {
        "type": "string"
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "limit": {
        "type": "number"
      },
      "offset": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  operationStatus: "Constructed" | "Suspended" | "Decomissioned" (upstream typo).

• getOnshoreWell

  read

  Full onshore well record by WELLREGNO (e.g. "L100/01- 1").

  Required paramswellRegNo

  Entitieswell
  Input schema

  {
    "type": "object",
    "properties": {
      "wellRegNo": {
        "type": "string",
        "examples": [
          "L100/01- 1"
        ]
      }
    },
    "additionalProperties": false,
    "required": [
      "wellRegNo"
    ]
  }

• searchFields

  read

  Search UK hydrocarbon fields (offshore or onshore) by name, operator, or status.

  Entitiesfield
  Input schema

  {
    "type": "object",
    "properties": {
      "fieldName": {
        "type": "string"
      },
      "operator": {
        "type": "string"
      },
      "status": {
        "type": "string",
        "examples": [
          "PRODUCING"
        ]
      },
      "onshore": {
        "type": "boolean"
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "limit": {
        "type": "number",
        "examples": [
          100
        ]
      },
      "offset": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  onshore:true → onshore layer (only FIELDNAME+FIELDTYPE available).

• getField

  read

  Full field record by exact field name (e.g. "FORTIES").

  Required paramsfieldName

  Entitiesfield
  Input schema

  {
    "type": "object",
    "properties": {
      "fieldName": {
        "type": "string",
        "examples": [
          "FORTIES"
        ]
      },
      "onshore": {
        "type": "boolean"
      }
    },
    "additionalProperties": false,
    "required": [
      "fieldName"
    ]
  }

• searchLicences

  read

  Search UK onshore petroleum licences by type, reference, operator, or round.

  Entitieslease
  Input schema

  {
    "type": "object",
    "properties": {
      "licenceRef": {
        "type": "string"
      },
      "licenceType": {
        "type": "string",
        "examples": [
          "PEDL"
        ]
      },
      "licenceStatus": {
        "type": "string"
      },
      "operator": {
        "type": "string",
        "examples": [
          "Egdon"
        ]
      },
      "region": {
        "type": "string"
      },
      "roundNumber": {
        "type": "number"
      },
      "offshore": {
        "type": "boolean"
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "limit": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  licenceType: PEDL|PL|ML|EXL|DL|CE|AL. offshore:true for UKCS blocks.

• getLicence

  read

  Full onshore licence record by LICREF (e.g. "PEDL137", "PL162").

  Required paramslicenceRef

  Entitieslease
  Input schema

  {
    "type": "object",
    "properties": {
      "licenceRef": {
        "type": "string",
        "examples": [
          "PEDL137"
        ]
      },
      "offshore": {
        "type": "boolean"
      }
    },
    "additionalProperties": false,
    "required": [
      "licenceRef"
    ]
  }

• searchPipelines

  read

  Search UKCS offshore infrastructure pipelines by name, fluid, status, or operator group.

  Entitiespipeline
  Input schema

  {
    "type": "object",
    "properties": {
      "pipelineName": {
        "type": "string"
      },
      "pipelineNumber": {
        "type": "string"
      },
      "reportingGroup": {
        "type": "string"
      },
      "fluid": {
        "type": "string",
        "examples": [
          "GAS"
        ]
      },
      "status": {
        "type": "string",
        "examples": [
          "ACTIVE"
        ]
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "limit": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  status: "ACTIVE" | "NOT IN USE" | "ABANDONED". fluid: "GAS" | "OIL" | "WATER".

• searchSubareas

  read

  Search UKCS offshore petroleum licence subareas by block, licence ref, operator, or round.

  Entitiesrecord
  Input schema

  {
    "type": "object",
    "properties": {
      "licenceRef": {
        "type": "string"
      },
      "blockRef": {
        "type": "string"
      },
      "licenceType": {
        "type": "string"
      },
      "operator": {
        "type": "string",
        "examples": [
          "Shell"
        ]
      },
      "roundNumber": {
        "type": "number",
        "examples": [
          33
        ]
      },
      "location": {
        "type": "string"
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "limit": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

• searchUndevelopedDiscoveries

  read

  Search UKCS offshore undeveloped petroleum discoveries by name, HC type, or well.

  Entitiesrecord
  Input schema

  {
    "type": "object",
    "properties": {
      "discName": {
        "type": "string"
      },
      "discCode": {
        "type": "string"
      },
      "wellRegNo": {
        "type": "string"
      },
      "hcType": {
        "type": "string",
        "examples": [
          "O"
        ]
      },
      "hasMontage": {
        "type": "boolean",
        "examples": [
          true
        ]
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "limit": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  hcType: O | G | GC | G&O | O&G. hasMontage:true filters to data-pack releases.

• searchRoundIndicativeAreas

  read

  List UKCS 33rd licencing round indicative geographic areas (3 records total).

  Entitiesrecord
  Input schema

  {
    "type": "object",
    "properties": {
      "round": {
        "type": "string"
      },
      "areaName": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

• searchCarbonStorage

  read

  Search current UKCS carbon storage (CCS) licence areas by bbox.

  Entitiesrecord
  Input schema

  {
    "type": "object",
    "properties": {
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "limit": {
        "type": "number",
        "examples": [
          100
        ]
      }
    },
    "additionalProperties": false
  }