Get CPO | OCPPLab Docs

Status + metadata for a single CPO.

AuthorizationBearer

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

cpo_idstringRequiredformat: "^\d+$"

CPO identifier. Backed by ocpp.partner_operations.id (string, positive integer).

CPO retrieved successfully

cpo_idstring

partyobject

The OCPI party identity the new CPO occupies.

name_prefixstring

templatestring

template_versioninteger

ocpi_peer_urlstring

topologyobject

Counts of entities the bundle wrote, so the caller knows what landed.

report_urlstring

destroy_urlstring

token_astring or null

Freshly minted Token A (present on create; None on GET).

roam_helperobject or null

Pre-built eMSP helper payload so the peer can handshake in one paste.

expires_atdatetime or null

created_atdatetime or null

updated_atdatetime or null

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/42"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"cpo_id": "101",
3	"party": {
4	"country_code": "FR",
5	"party_id": "ABC",
6	"role": "CPO"
7	},
8	"name_prefix": "demo",
9	"template": "small-urban-ac",
10	"template_version": 1,
11	"ocpi_peer_url": "https://api.ocpplab.test/ocpi/2.2.1/versions",
12	"topology": {
13	"locations": 2,
14	"chargers": 6,
15	"evses": 6,
16	"connectors": 6
17	},
18	"report_url": "/ocpi/cpos/101/report",
19	"destroy_url": "/ocpi/cpos/101",
20	"expires_at": "2026-04-21T21:00:00Z",
21	"created_at": "2026-04-21T20:00:00Z",
22	"updated_at": "2026-04-21T20:00:30Z"
23	}

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

1	{
2	"cpo_id": "101",
3	"party": {
4	"country_code": "FR",
5	"party_id": "ABC",
6	"role": "CPO"
7	},
8	"name_prefix": "demo",
9	"template": "small-urban-ac",
10	"template_version": 1,
11	"ocpi_peer_url": "https://api.ocpplab.test/ocpi/2.2.1/versions",
12	"topology": {
13	"locations": 2,
14	"chargers": 6,
15	"evses": 6,
16	"connectors": 6
17	},
18	"report_url": "/ocpi/cpos/101/report",
19	"destroy_url": "/ocpi/cpos/101",
20	"expires_at": "2026-04-21T21:00:00Z",
21	"created_at": "2026-04-21T20:00:00Z",
22	"updated_at": "2026-04-21T20:00:30Z"
23	}