---
title: "Cross Border Physical Flows"
method: GET
path: "/cbpf"
tags: ["import_export"]
---

# Cross Border Physical Flows

`GET /cbpf`

## Request

- Base URL: `https://api.energy-charts.info` (the document declares no server; this is the origin it was published from)
- URL: `https://api.energy-charts.info/cbpf`
- Auth: none declared
- TypeScript: <https://skmtc.dev/energy-charts/apis/energy-charts-api/docs/cbpf/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the cross-border physical flows (cbpfs) of electricity in GW between a specified country and its neighbors.
        

Positive values indicate an import of electricity, whereas negative values show electricity exports.
        


        

Response schema:
        

```json
{
    "unix_seconds": [int],
    "countries": [
        {
        "name": str,
        "data": [float]
        }
    ],
    "deprecated": bool
}
```

## Query parameters

- `country` string
- `start` string
- `end` string

## Response `200`

Successful Response

- CrossBorderModel
  - `unix_seconds` integer[], nullable
  - `countries` NamedData[], nullable
    - `name` string, required
    - `data` number[], required
  - `deprecated` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2025-05-06** `63bae0186e06`: 4 breaking, 3 info
  - for the `query` request parameter `end`, default value was changed from `2023-01-01T23:45+01:00` to ``
  - for the `query` request parameter `start`, default value was changed from `2023-01-01T00:00+01:00` to ``
  - response property `countries` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `unix_seconds` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …3 more

[Operation history](https://skmtc.dev/energy-charts/apis/energy-charts-api/changes/cbpf/get.md)

---

[API](https://skmtc.dev/energy-charts/apis/energy-charts-api.md) - [All operations](https://skmtc.dev/energy-charts/apis/energy-charts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/energy-charts/apis/energy-charts-api/revisions/523d3ec0fd82?raw)