List locations in a network

import requests
url = "https://host.com/ocpi/cpos/cpo_id/locations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "id": "loc-42",
      "ocpp_location_id": "ocpp-loc-42",
      "organization_id": "1f8d2d8e-0c43-4c2a-9b0a-6d6b4f5c2a11",
      "slug": "la-defense-charging-hub-ab12cd34",
      "name": "La Defense Charging Hub",
      "address": "14 Rue de la Paix",
      "city": "Paris",
      "country": "FR",
      "coordinates": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "timezone": "Europe/Paris",
      "owner_name": "VINCI Autoroutes",
      "public": true,
      "chargers": [
        {
          "id": "dep-001",
          "identity": "SITE_A_001",
          "connector_type": "CCS2",
          "ocpp_version": "OCPP1.6"
        }
      ],
      "created_at": "2026-04-16T10:15:30Z",
      "updated_at": "2026-04-16T10:15:30Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}

import requests
url = "https://host.com/ocpi/cpos/cpo_id/locations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "id": "loc-42",
      "ocpp_location_id": "ocpp-loc-42",
      "organization_id": "1f8d2d8e-0c43-4c2a-9b0a-6d6b4f5c2a11",
      "slug": "la-defense-charging-hub-ab12cd34",
      "name": "La Defense Charging Hub",
      "address": "14 Rue de la Paix",
      "city": "Paris",
      "country": "FR",
      "coordinates": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "timezone": "Europe/Paris",
      "owner_name": "VINCI Autoroutes",
      "public": true,
      "chargers": [
        {
          "id": "dep-001",
          "identity": "SITE_A_001",
          "connector_type": "CCS2",
          "ocpp_version": "OCPP1.6"
        }
      ],
      "created_at": "2026-04-16T10:15:30Z",
      "updated_at": "2026-04-16T10:15:30Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}

Retrieve a paginated list of OCPI locations attached to one network (ocpp.partner_operations.id) within the current organization.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

cpo_idstringRequiredformat: "^\d+$"

CPO identifier — the stringified integer returned by POST /ocpi/cpos (backed by ocpp.partner_operations.id).

Query parameters

pageintegerOptional>=1Defaults to 1

One-based page number for paginated results.

limitintegerOptional1-100Defaults to 50

Maximum number of locations to return per page.

Response

Locations retrieved successfully

datalist of objects

totalinteger

pageinteger

limitinteger

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

1	import requests
2
3	url = "https://host.com/ocpi/cpos/cpo_id/locations"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"data": [
3	{
4	"id": "loc-42",
5	"ocpp_location_id": "ocpp-loc-42",
6	"organization_id": "1f8d2d8e-0c43-4c2a-9b0a-6d6b4f5c2a11",
7	"slug": "la-defense-charging-hub-ab12cd34",
8	"name": "La Defense Charging Hub",
9	"address": "14 Rue de la Paix",
10	"city": "Paris",
11	"country": "FR",
12	"coordinates": {
13	"latitude": 48.8566,
14	"longitude": 2.3522
15	},
16	"timezone": "Europe/Paris",
17	"owner_name": "VINCI Autoroutes",
18	"public": true,
19	"chargers": [
20	{
21	"id": "dep-001",
22	"identity": "SITE_A_001",
23	"connector_type": "CCS2",
24	"ocpp_version": "OCPP1.6"
25	}
26	],
27	"created_at": "2026-04-16T10:15:30Z",
28	"updated_at": "2026-04-16T10:15:30Z"
29	}
30	],
31	"total": 1,
32	"page": 1,
33	"limit": 50
34	}