# Energy Intelligence API

> Read Great Britain electricity carbon intensity, regional figures, generation mix, and forecasts from the Carbon Intensity API.

Each POST has a fixed USDC price on Base, paid with the x402 exact scheme. The request is validated first, and payment settles only after a successful (2xx) result. Failed calls are not charged.

1. POST JSON matching the requestBody. Invalid input returns 400 with no payment challenge.
2. A valid unpaid call returns 402 with the exact amount and payTo.
3. Pay and retry with payment-signature. Payment settles only if the operation returns 2xx. A 4xx/5xx is not charged.

- Product: https://www.brainiac.software/api/energy-intelligence
- Docs: https://www.brainiac.software/api/energy-intelligence/docs
- OpenAPI: https://www.brainiac.software/api/energy-intelligence/openapi.json
- Contact: support@brainiac.software (https://www.brainiac.software/contact)

## Operations

### POST /api/v1/energy-intelligence/current

$0.02 USDC. Retrieve current GB electricity carbon intensity from the Carbon Intensity API. Supports optional regional filtering.

Inputs: regionId?

Docs: https://www.brainiac.software/api/energy-intelligence/docs#energy-intelligence-current

Example request:

```json
{
  "regionId": 18
}
```

Example response:

```json
undefined
```

### POST /api/v1/energy-intelligence/historical

$0.05 USDC. Retrieve historical or forecast carbon intensity data for a specific time period from the Carbon Intensity API. Supports regional filtering.

Inputs: from?, to?, regionId?

Docs: https://www.brainiac.software/api/energy-intelligence/docs#energy-intelligence-historical

Example request:

```json
{
  "from": "2026-11-01T00:00:00Z",
  "to": "2026-11-01T23:30:00Z"
}
```

Example response:

```json
undefined
```

### POST /api/v1/energy-intelligence/regional

$0.05 USDC. Retrieve carbon intensity data for all GB regions or a specific region from the Carbon Intensity API. Includes generation mix information.

Inputs: regionId?

Docs: https://www.brainiac.software/api/energy-intelligence/docs#energy-intelligence-regional

Example request:

```json
{
  "regionId": 1
}
```

Example response:

```json
undefined
```

### POST /api/v1/energy-intelligence/generation-mix

$0.03 USDC. Retrieve electricity generation mix data showing fuel type proportions from the Carbon Intensity API. Supports regional and time-based filtering.

Inputs: from?, to?, regionId?

Docs: https://www.brainiac.software/api/energy-intelligence/docs#energy-intelligence-generation-mix

Example request:

```json
{
  "from": "2026-11-01T12:00:00Z",
  "to": "2026-11-01T12:30:00Z"
}
```

Example response:

```json
undefined
```

### POST /api/v1/energy-intelligence/forecast

$0.03 USDC. Retrieve forecast carbon intensity data from the Carbon Intensity API. Supports regional filtering.

Inputs: from?, to?, regionId?

Docs: https://www.brainiac.software/api/energy-intelligence/docs#energy-intelligence-forecast

Example request:

```json
{
  "from": "2026-11-02T00:00:00Z",
  "to": "2026-11-02T23:30:00Z"
}
```

Example response:

```json
undefined
```

### POST /api/v1/energy-intelligence/regions

$0.01 USDC. Retrieve metadata for all GB regions supported by the Carbon Intensity API including region IDs and names.

Inputs: none

Docs: https://www.brainiac.software/api/energy-intelligence/docs#energy-intelligence-regions

Example request:

```json
{}
```

Example response:

```json
undefined
```

### POST /api/v1/energy-intelligence/report

$0.05 USDC. Generate a comprehensive energy intelligence report combining current intensity, regional data, and generation mix from the Carbon Intensity API.

Inputs: regionId?

Docs: https://www.brainiac.software/api/energy-intelligence/docs#energy-intelligence-report

Example request:

```json
{
  "regionId": 18
}
```

Example response:

```json
undefined
```