Get bulk location-create job status

Lightweight poll endpoint for the async bulk-create flow. Returns the job’s current state (PENDING / PROVISIONING / READY / FAILED), the workflow run id for debugging, error when the workflow terminated unsuccessfully, and results with the created location ids on READY.

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).

job_idstringRequired

Response

Status retrieved

job_idstring

job_typestring or null

statusenum or null

State machine for the durable bulk-location async job.

workflow_run_idstring or null

errorobject or null

Populated when status=FAILED. Clients can branch on error.code and use error.retryable to decide whether to re-submit.

resultsmap from strings to any or null

provisioned_atdatetime or null

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

1	{
2	"job_id": "4f6b5e0e-7d1a-4b0a-9c2e-abc123456789",
3	"job_type": "bulk_location_create",
4	"status": "READY",
5	"workflow_run_id": "wfr_abc123",
6	"results": {
7	"count": 2,
8	"location_ids": [
9	"loc-1",
10	"loc-2"
11	]
12	},
13	"provisioned_at": "2026-04-19T15:45:00Z"
14	}