# Gasstorage — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Monitor Danish gas storage capacity, hourly nominations, and daily utilization metrics in real-time to track energy supply and storage operations across the country's facilities. Access detailed data on storage levels and gas flow patterns to make informed decisions about energy management and market analysis.

**Category:** Government & Public Data | **Website:** [gasstorage.dk/](https://gasstorage.dk/) | **Docs:** [parse.bot/marketplace/db300731-9020-4420-bccc-554ad8ff6b4f/gasstorage-dk-api](https://parse.bot/marketplace/db300731-9020-4420-bccc-554ad8ff6b4f/gasstorage-dk-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/gasstorage/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get capacities

Fetch daily storage capacity data including volume, injection, and withdrawal capacities. Each record shows technical capacity, reserved capacity, TSO-reserved capacity, and available capacity for volume (MWh), injection (MWh/h), and withdrawal (MWh/h). Paginates internally up to the requested limit. Default sort is GasDay descending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `columns` | string | No | Comma-separated list of columns to include (e.g. 'GasDay,CapacityVolumeAvailable,CapacityInjectionAvailable'). |
| `end` | string | No | End date in ISO format (e.g. '2024-12-31'). Filters records up to this date. |
| `limit` | integer | No | Maximum number of records to return. |
| `sort` | string | No | Sort field and direction (e.g. 'GasDay asc' or 'GasDay desc'). |
| `start` | string | No | Start date in ISO format (e.g. '2024-01-01'). Filters records from this date. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/gasstorage/get-capacities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"columns":"<string>","end":"<string>","limit":"<integer>","sort":"<string>","start":"<string>"}'
```

### Get nominations

Fetch hourly storage nomination data including injection and withdrawal nominations, split into firm and interruptible categories. Values are in kWh/h. Default sort is HourUTC descending. Paginates internally up to the requested limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `columns` | string | No | Comma-separated list of columns to include (e.g. 'HourDK,NominationInjectionFirm,NominationWithdrawalFirm'). |
| `end` | string | No | End datetime in ISO format. Filters records up to this time. |
| `limit` | integer | No | Maximum number of records to return. |
| `sort` | string | No | Sort field and direction (e.g. 'HourUTC desc' or 'HourDK asc'). |
| `start` | string | No | Start datetime in ISO format (e.g. '2024-01-01' or '2024-01-01T06:00'). Filters records from this time. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/gasstorage/get-nominations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"columns":"<string>","end":"<string>","limit":"<integer>","sort":"<string>","start":"<string>"}'
```

### Get utilization

Fetch daily storage utilization data including total stored volumes, injected volumes, withdrawn volumes, interruptible components, and expected capacities. Default sort is GasDay descending. Paginates internally up to the requested limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `columns` | string | No | Comma-separated list of columns to include (e.g. 'GasDay,StoredTotal,InjectedTotal,WithdrawedTotal'). |
| `end` | string | No | End date in ISO format (e.g. '2024-12-31'). Filters records up to this date. |
| `limit` | integer | No | Maximum number of records to return. |
| `sort` | string | No | Sort field and direction (e.g. 'GasDay asc' or 'GasDay desc'). |
| `start` | string | No | Start date in ISO format (e.g. '2024-01-01'). Filters records from this date. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/gasstorage/get-utilization \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"columns":"<string>","end":"<string>","limit":"<integer>","sort":"<string>","start":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.