Data

Retrieve licensed STOREtrack project and market-trends data using a bearer token issued by the Data Portal API.

1. Request a bearer token

Send a POST request to:

https://delta-portal-webapp-prd-uks-app.azurewebsites.net/external-api/auth/token

With your email address and API key:

{
  "email": "{{email}}",
  "apiKey": "{{apiKey}}"
}

Use the returned token as a bearer token when calling the STOREtrack API:

Authorization: Bearer {{token}}
Content-Type: application/json

The data returned is restricted according to the STOREtrack products, countries, and data covered by your API licence.

2. Retrieve projects

Send a POST request to:

https://storetrack-api-prd-uks-app.azurewebsites.net/api/ExternalApi/Projects

The request body is optional. Omitting it returns all projects available under your API licence.

A filter object can be supplied to restrict the results:

{
  "countries": ["GB"],
  "technologies": ["Lithium-ion"],
  "operational": ["Operational"],
  "pumpedStorage": false
}

The response is a JSON array containing the accessible STOREtrack projects which match the supplied filters.

3. Retrieve market trends

Send a POST request to:

https://storetrack-api-prd-uks-app.azurewebsites.net/api/ExternalApi/MarketTrends

An empty filter object can be used to request the default market-trends results:

{}

The external API defaults to:

Forecast data
Pumped storage excluded
All accessible countries, segments, installations and technologies

These defaults can be overridden in the request body:

{
  "countries": ["AA"],
  "segments": ["AA"],
  "installations": ["AA"],
  "technologies": ["AA"],
  "operational": [],
  "pumpedStorage": true,
  "actual": 1
}

The response contains aggregated STOREtrack market-trends data, including annual and cumulative power, storage capacity, and project-count figures.

Filter values

The following common filters can be supplied to either endpoint:

Property	Type	Description
`countries`	`string[]`	Country codes to include. Use `"AA"` or omit the property for all accessible countries.
`segments`	`string[]`	Market segments to include. Use `"AA"` or omit the property for all segments.
`installations`	`string[]`	Installation types to include. Use `"AA"` or omit the property for all installation types.
`technologies`	`string[]`	Technologies to include. Use `"AA"` or omit the property for all technologies.
`operational`	`string[]`	Project statuses to include.
`pumpedStorage`	`boolean`	Whether pumped-storage projects should be included.
`actual`	`number`	Selects actual or forecast data. See the values below.

Actual and forecast values

Value	Meaning
`1`	Actual
`2`	Forecast

For the Market Trends endpoint, actual defaults to 2 and pumpedStorage defaults to false. Both values can be explicitly overridden in the POST body.

Additional project filters

The Projects endpoint also supports the following optional filters:

Property	Type	Description
`useDateRange`	`boolean`	Enables filtering using `dateRange`.
`dateRange`	`object`	Date range containing `startDate` and `endDate`.
`usePowerCapacityRange`	`boolean`	Enables filtering using `powerCapacityRange`.
`powerCapacityRange`	`object`	Power range containing `minimum` and `maximum`.
`useStorageCapacityRange`	`boolean`	Enables filtering using `storageCapacityRange`.
`storageCapacityRange`	`object`	Storage range containing `minimum` and `maximum`.
`useDurationRange`	`boolean`	Enables filtering using `durationRange`.
`durationRange`	`object`	Duration range containing `minimum` and `maximum`.
`useOperationalDateRange`	`boolean`	Enables filtering using `operationalDateRange`.
`operationalDateRange`	`object`	Operational-year range containing `minimum` and `maximum`.
`useUnderConstructionDateRange`	`boolean`	Enables filtering using `underConstructionDateRange`.
`underConstructionDateRange`	`object`	Construction-year range containing `minimum` and `maximum`.
`useLatestUpdateWithin`	`boolean`	Enables filtering by how recently a project was updated.
`latestUpdateWithin`	`number`	Maximum age of the latest project update.
`valueStreams`	`string[]`	Value streams to include.
`projectsLookingForA`	`string`	Filters projects by what they are seeking.
`companiesInvolved`	`string[]`	Companies involved in a project.
`companyRoles`	`string[]`	Company roles to include.

For example:

{
  "countries": ["GB"],
  "technologies": ["Lithium-ion"],
  "pumpedStorage": false,
  "usePowerCapacityRange": true,
  "powerCapacityRange": {
    "minimum": 10,
    "maximum": 100
  },
  "useOperationalDateRange": true,
  "operationalDateRange": {
    "minimum": 2024,
    "maximum": 2030
  }
}