Energy Intelligence API Documentation

POSThttps://www.brainiac.software/api/v1/energy-intelligence/current$0.02 USDC

Get current carbon intensity

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

Body

Field	Required	Notes
`regionId`	No	integer

Request exampleJSON

{
  "regionId": 18
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/energy-intelligence/current" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "regionId": 18
}
JSON

POSThttps://www.brainiac.software/api/v1/energy-intelligence/historical$0.05 USDC

Get historical carbon intensity

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

Body

Field	Required	Notes
`from`	No	string; date-time
`to`	No	string; date-time
`regionId`	No	integer

Request exampleJSON

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

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/energy-intelligence/historical" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "from": "2026-11-01T00:00:00Z",
  "to": "2026-11-01T23:30:00Z"
}
JSON

POSThttps://www.brainiac.software/api/v1/energy-intelligence/regional$0.05 USDC

Get regional carbon intensity

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

Body

Field	Required	Notes
`regionId`	No	integer

Request exampleJSON

{
  "regionId": 1
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/energy-intelligence/regional" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "regionId": 1
}
JSON

POSThttps://www.brainiac.software/api/v1/energy-intelligence/generation-mix$0.03 USDC

Get generation mix

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

Body

Field	Required	Notes
`from`	No	string; date-time
`to`	No	string; date-time
`regionId`	No	integer

Request exampleJSON

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

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/energy-intelligence/generation-mix" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "from": "2026-11-01T12:00:00Z",
  "to": "2026-11-01T12:30:00Z"
}
JSON

POSThttps://www.brainiac.software/api/v1/energy-intelligence/forecast$0.03 USDC

Get carbon intensity forecast

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

Body

Field	Required	Notes
`from`	No	string; date-time
`to`	No	string; date-time
`regionId`	No	integer

Request exampleJSON

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

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/energy-intelligence/forecast" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "from": "2026-11-02T00:00:00Z",
  "to": "2026-11-02T23:30:00Z"
}
JSON

POSThttps://www.brainiac.software/api/v1/energy-intelligence/regions$0.01 USDC

Get all regions

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

Body

Send the JSON body shown in the request example.

Request exampleJSON

{}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/energy-intelligence/regions" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{}
JSON

POSThttps://www.brainiac.software/api/v1/energy-intelligence/report$0.05 USDC

Get energy intelligence report

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

Body

Field	Required	Notes
`regionId`	No	integer

Request exampleJSON

{
  "regionId": 18
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/energy-intelligence/report" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "regionId": 18
}
JSON