# Sodir Norwegian Offshore Petroleum FactMaps API

> Norwegian Offshore Directorate: wellbores, oil and gas fields, facilities, pipelines, licences

- Vendor: `sodirnorwegianoffshorepetroleu` · version 1.0 · category Energy · tags oil and gas fields api, wellbores api, petroleum licences api, offshore facilities api, npd factpages api, sodir api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/sodirnorwegianoffshorepetroleu
- This document: https://apiclay.com/docs/sodirnorwegianoffshorepetroleu.md
- OpenAPI 3.1: https://apiclay.com/api/sodirnorwegianoffshorepetroleu/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `sodirnorwegianoffshorepetroleu`
- Updated: 2026-11-18

## About

## Sodir Norwegian Offshore Petroleum FactMaps API

The official FactMaps of the Norwegian Offshore Directorate (Sodir, formerly the Norwegian Petroleum Directorate), synced daily with its databases: every wellbore on the Norwegian Continental Shelf (exploration, development, CO2 storage) with operator, purpose, status, dates, depth and result; oil and gas fields with status, discovery year, operator and hydrocarbon type; discoveries; facilities and pipelines; production and CO2 licences with operators; seismic and other surveys; blocks and quadrants. Each layer can be filtered with SQL-style conditions and returned with or without geometry.

Data comes from **factmaps.sodir.no** (https://factmaps.sodir.no). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/layers` for the layer ids, then `/query?layer=502&amp;where=1=1&amp;outFields=*&amp;returnGeometry=false` for all fields, or `where=fldName='JOHAN SVERDRUP'` for one.

### Routes

#### GET `/layers` - Layers
No parameters.

Returns: Service description and `layers` (`id`, `name`, `parentLayerId`, `subLayerIds`), e.g. `201` all wellbores, `203` active exploration wellbores, `502` fields by status, `504` all discoveries, `307` all facilities, `311` pipelines, `617` all production licences, `627` CO2 licences, `420` all surveys, `802` blocks; and `tables` (e.g. `515` field reserves, `532` discovery reserves, `655` licensees, `101` companies), which `/query` reads the same way (see their fields with `/layer`).

#### GET `/layer` - Layer
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| layer | path | number | yes | Layer id from `/layers`, e.g. `502`. |

Returns: The layer's `name`, `geometryType`, `fields` (`name`, `alias`, `type`), `maxRecordCount` and extent; use the field names in `where`, `outFields` and `orderByFields`.

#### GET `/query` - Query
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| layer | path | number | yes | Layer id, e.g. `502` (fields) or `201` (wellbores). |
| where | query | string | yes | SQL condition, e.g. `1=1` for all or `fldName='JOHAN SVERDRUP'`. |
| outFields | query | string | no | Comma-separated field names, or `*`. |
| returnGeometry | query | string | no | `false` to skip shapes (much smaller). |
| resultRecordCount | query | number | no | Records per page, up to 1,000. |
| resultOffset | query | number | no | Records to skip, for paging. |
| orderByFields | query | string | no | e.g. `fldDiscoveryYear DESC`. |
| outSR | query | string | no | Output spatial reference, e.g. `4326` for lat/lon (default ED50 UTM 32). |

Returns: `fields` (schema), `features` (`attributes` per record, plus `geometry` unless `returnGeometry=false`) and `exceededTransferLimit` when more pages remain. Fields carry Sodir names, e.g. `fldName`, `fldCurrentActivitySatus`, `fldDiscoveryYear`, `fldHcType`, `cmpLongName` (operator); wellbores `wlbWellboreName`, `wlbDrillingOperator`, `wlbPurpose`, `wlbStatus`, `wlbTotalDepth`.

### Caveats

- 1,000 wellbores without geometry are about 3.4 MB; with geometry, layers grow quickly, so page with `resultRecordCount` and `resultOffset`.
- Sodir publishes this data as open government data (NLOD); credit the Norwegian Offshore Directorate.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by factmaps.sodir.no.

## Pricing

- Pay as you go: 0.0045 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /layers — Layers
- Gateway: `GET https://api.apiclay.com/v1/api/sodirnorwegianoffshorepetroleu/layers`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /layer — Layer
- Gateway: `GET https://api.apiclay.com/v1/api/sodirnorwegianoffshorepetroleu/layer`
- Public query params: `layer` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /query — Query
- Gateway: `GET https://api.apiclay.com/v1/api/sodirnorwegianoffshorepetroleu/query`
- Public query params: `where` (string, required), `outFields` (string), `returnGeometry` (string), `resultRecordCount` (number), `resultOffset` (number), `orderByFields` (string), `outSR` (string), `layer` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 8 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/sodirnorwegianoffshorepetroleu/layers" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
