Sodir (Norwegian Offshore Directorate) data contract

Provenance

PublisherSodir (Norwegian Offshore Directorate)

API basehttps://factmaps.sodir.no/api/rest/services/DataService/Data/FeatureServer

Freshness & coverage

FreshnessFreshness not declared

GeographicNot declared

TemporalNot declared

AuthenticationNo credentials required

Methods (13)

searchWellbores

read

NCS wellbores — filter by operator, status, purpose, content, field, date

Entitieswell

Input schema

{
  "type": "object",
  "properties": {
    "wellboreName": {
      "type": "string"
    },
    "operator": {
      "type": "string",
      "examples": [
        "Equinor"
      ]
    },
    "status": {
      "type": "string",
      "examples": [
        "PRODUCING"
      ]
    },
    "purpose": {
      "type": "string"
    },
    "content": {
      "type": "string"
    },
    "wellType": {
      "type": "string"
    },
    "field": {
      "type": "string"
    },
    "licence": {
      "type": "string"
    },
    "mainArea": {
      "type": "string"
    },
    "completedAfter": {
      "type": "string"
    },
    "completedBefore": {
      "type": "string"
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "limit": {
      "type": "number",
      "examples": [
        50
      ]
    },
    "offset": {
      "type": "number"
    },
    "orderBy": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

getWellbore

read

Single NCS wellbore by name (e.g. '33/12-1') or NPDID integer

Entitieswell

Input schema

{
  "type": "object",
  "properties": {
    "wellboreName": {
      "type": "string",
      "examples": [
        "33/12-1"
      ]
    },
    "npdid": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

Pass wellboreName or npdid — one is required

searchFields

read

NCS fields — filter name, status (Producing/Approved/Shut down), hcType

Entitiesfield

Input schema

{
  "type": "object",
  "properties": {
    "fieldName": {
      "type": "string"
    },
    "activityStatus": {
      "type": "string",
      "examples": [
        "Producing"
      ]
    },
    "hcType": {
      "type": "string"
    },
    "mainArea": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

searchDiscoveries

read

NCS discoveries — filter by name, status, hcType, operator, year range

Entitiesrecord

Input schema

{
  "type": "object",
  "properties": {
    "discoveryName": {
      "type": "string"
    },
    "activityStatus": {
      "type": "string",
      "examples": [
        "Production is unlikely"
      ]
    },
    "hcType": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "discoveredAfter": {
      "type": "number"
    },
    "discoveredBefore": {
      "type": "number"
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

searchLicences

read

NCS production licences — filter by name, status (ACTIVE/INACTIVE), area

Entitieslease

Input schema

{
  "type": "object",
  "properties": {
    "licenceName": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "active": {
      "type": "boolean",
      "examples": [
        true
      ]
    },
    "mainArea": {
      "type": "string",
      "examples": [
        "NORTH SEA"
      ]
    },
    "operator": {
      "type": "string"
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

searchPipelines

read

NCS offshore pipelines — filter by name, medium (OIL/GAS), phase

Entitiespipeline

Input schema

{
  "type": "object",
  "properties": {
    "pipelineName": {
      "type": "string"
    },
    "medium": {
      "type": "string",
      "examples": [
        "OIL"
      ]
    },
    "currentPhase": {
      "type": "string"
    },
    "fromFacility": {
      "type": "string"
    },
    "toFacility": {
      "type": "string"
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

searchFacilities

read

NCS platforms, FPSOs, subsea — filter by name, kind, phase, operator

Entitiesrecord

Input schema

{
  "type": "object",
  "properties": {
    "facilityName": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "examples": [
        "FPSO"
      ]
    },
    "phase": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "limit": {
      "type": "number",
      "examples": [
        20
      ]
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

searchSeismicSurveys

read

NCS seismic acquisition areas — filter name, category (2D/3D), status

Entitiessurvey

Input schema

{
  "type": "object",
  "properties": {
    "surveyName": {
      "type": "string"
    },
    "category": {
      "type": "string",
      "examples": [
        "3D"
      ]
    },
    "status": {
      "type": "string"
    },
    "geographicalArea": {
      "type": "string"
    },
    "marketAvailable": {
      "type": "boolean",
      "examples": [
        true
      ]
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

searchCompanies

read

NCS operators and licensees — filter by name, active status, role

Entitiescompany

Input schema

{
  "type": "object",
  "properties": {
    "companyName": {
      "type": "string"
    },
    "activeOnNcs": {
      "type": "boolean",
      "examples": [
        true
      ]
    },
    "licenceOperator": {
      "type": "boolean",
      "examples": [
        true
      ]
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

getWellboreFormationTops

read

Lithostratigraphic formation tops for a wellbore — requires NPDID

Required paramsnpdid

Entitiesformation, well

Input schema

{
  "type": "object",
  "properties": {
    "npdid": {
      "type": "number",
      "examples": [
        417
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "npdid"
  ]
}

Cached 24h — historical, immutable per well

getWellboreDST

read

Drill stem tests for a wellbore — requires NPDID integer

Required paramsnpdid

Entitiescompletion, well

Input schema

{
  "type": "object",
  "properties": {
    "npdid": {
      "type": "number",
      "examples": [
        417
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "npdid"
  ]
}

Cached 24h — historical per well

getWellboreHistory

read

Narrative drilling history for a wellbore (HTML) — requires NPDID

Required paramsnpdid

Entitieswell

Input schema

{
  "type": "object",
  "properties": {
    "npdid": {
      "type": "number",
      "examples": [
        417
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "npdid"
  ]
}

wlbHistory is HTML-formatted legacy text

getFieldReserves

read

Oil/gas/NGL/condensate reserves per field — multi-vintage, needs NPDID

Required paramsnpdid

Entitiesproduction, field

Input schema

{
  "type": "object",
  "properties": {
    "npdid": {
      "type": "number",
      "examples": [
        43658
      ]
    },
    "latestOnly": {
      "type": "boolean",
      "examples": [
        true
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "npdid"
  ]
}

Pass latestOnly:true for most recent vintage