OpenAPI reference

Receiver EVSE

PUT/locations/{country_code}/{party_id}/{location_id}/{evse_uid}

Push a new or updated EVSE object. Path ``evse_uid`` MUST equal ``body.uid`` (2001 on mismatch).

API: OCPI 2.2.1 (eMSP) · Module: Locations (eMSP)
Base path: /locations · Base URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1

Overview

PUT /locations/{country_code}/{party_id}/{location_id}/{evse_uid}

Absolute URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/locations/{country_code}/{party_id}/{location_id}/{evse_uid}

Push a new or updated EVSE object. Path evse_uid MUST equal body.uid (2001 on mismatch).

Requires authentication. Use Authorization: Token <token>. See OCPI credentials.

How to call

Quick Shell sample (set OCPI_TOKEN when auth is required). Full Python and TypeScript under Examples.

1curl -sS -X PUT 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/locations/NL/ABC/LOC1/EVSE1' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"uid":"3256","evse_id":"BE*BEC*E041503001","status":"AVAILABLE","capabilities":["RESERVABLE"],"connectors":[{"id":"1","standard":"IEC_62196_T2","format":"CABLE","power_type":"AC_3_PHASE","max_voltage":220,"max_amperage":16,"tariff_ids":["11"],"last_updated":"2015-06-29T21:39:01Z"}],"last_updated":"2015-06-29T21:39:01Z"}'

Request

Path parameters

Name	Type	Required	Description
`country_code`	`string`	Yes	ISO-3166 alpha-2 country code (uppercase).
`party_id`	`string`	Yes	CPO/eMSP party ID (ISO-15118, 3 uppercase alphanumerics).
`location_id`	`string`	Yes	Location.id of the Location object.
`evse_uid`	`string`	Yes	EVSE.uid of the EVSE object.

Request body

application/json · Required

Schema: EVSE

Field	Type	Required	Description
`uid`	`string`	Yes	—
`evse_id`	`string`	No	—
`status`	`"AVAILABLE"	"BLOCKED"	"CHARGING"
`status_schedule`	`StatusSchedule[]`	No	—
`capabilities`	`"CHARGING_PROFILE_CAPABLE"	"CHARGING_PREFERENCES_CAPABLE"	"CHIP_CARD_SUPPORT"
`connectors`	`Connector[]`	Yes	`Connectors`
`floor_level`	`string`	No	—
`coordinates`	`GeoLocation`	No	`GeoLocation`
`physical_reference`	`string`	No	—
`directions`	`DisplayText[]`	No	—
`parking_restrictions`	`"EV_ONLY"	"PLUGGED"	"DISABLED"
`images`	`Image[]`	No	—
`last_updated`	`string (date-time)`	Yes	—

Request example

1{
2  "uid": "3256",
3  "evse_id": "BE*BEC*E041503001",
4  "status": "AVAILABLE",
5  "capabilities": [
6    "RESERVABLE"
7  ],
8  "connectors": [
9    {
10      "id": "1",
11      "standard": "IEC_62196_T2",
12      "format": "CABLE",
13      "power_type": "AC_3_PHASE",
14      "max_voltage": 220,
15      "max_amperage": 16,
16      "tariff_ids": [
17        "11"
18      ],
19      "last_updated": "2015-06-29T21:39:01Z"
20    }
21  ],
22  "last_updated": "2015-06-29T21:39:01Z"
23}

Responses

Status	Description	Schema
`200`	Successful Response	`EvseResponse`
`400`	Invalid or missing parameters (HTTP 200, OCPI envelope)	`—`
`401`	Unauthorized	`—`
`422`	Validation Error	`HTTPValidationError`

`200` — successful response

application/json

Schema: EvseResponse

Field	Type	Required	Description
`status_code`	`integer`	No	Default: `1000`
`status_message`	`string`	No	—
`timestamp`	`string (date-time)`	No	—
`data`	`EVSE`	No	`EVSE`

Response example

1{
2  "status_code": 1000,
3  "status_message": "Success",
4  "timestamp": "2024-01-15T10:00:00Z",
5  "data": {
6    "capabilities": [
7      "RFID_READER",
8      "REMOTE_START_STOP_CAPABLE"
9    ],
10    "connectors": [
11      {
12        "format": "SOCKET",
13        "id": "1",
14        "last_updated": "2024-01-15T10:00:00Z",
15        "max_amperage": 32,
16        "max_voltage": 400,
17        "power_type": "AC_3_PHASE",
18        "standard": "IEC_62196_T2",
19        "tariff_ids": [
20          "TARIFF-001"
21        ]
22      }
23    ],
24    "coordinates": {
25      "latitude": "51.04759",
26      "longitude": "3.72994"
27    },
28    "directions": [
29      {
30        "language": "en",
31        "text": "Near the entrance"
32      }
33    ],
34    "evse_id": "BE-BEC-E041503001",
35    "floor_level": "-1",
36    "images": [],
37    "last_updated": "2024-01-15T10:00:00Z",
38    "parking_restrictions": [
39      "EV_ONLY"
40    ],
41    "physical_reference": "3",
42    "status": "AVAILABLE",
43    "status_schedule": [],
44    "uid": "3256"
45  }
46}

`400` — invalid or missing parameters (HTTP 200, OCPI envelope)

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Invalid or missing parameters",
4  "timestamp": "2025-01-01T00:00:00Z",
5  "doc_url": "https://github.com/ocpplab/ocpi-gateway/blob/main/docs/errors.md#2001-invalid-parameters",
6  "errors": [
7    {
8      "field": "country_code",
9      "message": "expected 'NL' to match Token A identity",
10      "type": "value_error.identity_mismatch"
11    }
12  ]
13}

`401` — unauthorized

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Unauthorized",
4  "timestamp": "2025-01-01T00:00:00Z"
5}

`422` — validation error

application/json

Schema: HTTPValidationError

Field	Type	Required	Description
`detail`	`ValidationError[]`	No	`Detail`

Response example

1{
2  "detail": [
3    {
4      "loc": [],
5      "msg": "string",
6      "type": "string",
7      "input": {
8        "_type": "Input"
9      },
10      "ctx": {
11        "_type": "Context"
12      }
13    }
14  ]
15}

Examples

Shell, Python, and TypeScript (set OCPI_TOKEN when auth is required).

1curl -sS -X PUT 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/locations/NL/ABC/LOC1/EVSE1' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"uid":"3256","evse_id":"BE*BEC*E041503001","status":"AVAILABLE","capabilities":["RESERVABLE"],"connectors":[{"id":"1","standard":"IEC_62196_T2","format":"CABLE","power_type":"AC_3_PHASE","max_voltage":220,"max_amperage":16,"tariff_ids":["11"],"last_updated":"2015-06-29T21:39:01Z"}],"last_updated":"2015-06-29T21:39:01Z"}'

OpenAPI reference

Receiver EVSE

PUT/locations/{country_code}/{party_id}/{location_id}/{evse_uid}

Push a new or updated EVSE object. Path ``evse_uid`` MUST equal ``body.uid`` (2001 on mismatch).

API: OCPI 2.2.1 (eMSP) · Module: Locations (eMSP)
Base path: /locations · Base URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1

Overview

PUT /locations/{country_code}/{party_id}/{location_id}/{evse_uid}

Absolute URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/locations/{country_code}/{party_id}/{location_id}/{evse_uid}

Push a new or updated EVSE object. Path evse_uid MUST equal body.uid (2001 on mismatch).

Requires authentication. Use Authorization: Token <token>. See OCPI credentials.

How to call

Quick Shell sample (set OCPI_TOKEN when auth is required). Full Python and TypeScript under Examples.

1curl -sS -X PUT 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/locations/NL/ABC/LOC1/EVSE1' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"uid":"3256","evse_id":"BE*BEC*E041503001","status":"AVAILABLE","capabilities":["RESERVABLE"],"connectors":[{"id":"1","standard":"IEC_62196_T2","format":"CABLE","power_type":"AC_3_PHASE","max_voltage":220,"max_amperage":16,"tariff_ids":["11"],"last_updated":"2015-06-29T21:39:01Z"}],"last_updated":"2015-06-29T21:39:01Z"}'

Request

Path parameters

Name	Type	Required	Description
`country_code`	`string`	Yes	ISO-3166 alpha-2 country code (uppercase).
`party_id`	`string`	Yes	CPO/eMSP party ID (ISO-15118, 3 uppercase alphanumerics).
`location_id`	`string`	Yes	Location.id of the Location object.
`evse_uid`	`string`	Yes	EVSE.uid of the EVSE object.

Request body

application/json · Required

Schema: EVSE

Field	Type	Required	Description
`uid`	`string`	Yes	—
`evse_id`	`string`	No	—
`status`	`"AVAILABLE"	"BLOCKED"	"CHARGING"
`status_schedule`	`StatusSchedule[]`	No	—
`capabilities`	`"CHARGING_PROFILE_CAPABLE"	"CHARGING_PREFERENCES_CAPABLE"	"CHIP_CARD_SUPPORT"
`connectors`	`Connector[]`	Yes	`Connectors`
`floor_level`	`string`	No	—
`coordinates`	`GeoLocation`	No	`GeoLocation`
`physical_reference`	`string`	No	—
`directions`	`DisplayText[]`	No	—
`parking_restrictions`	`"EV_ONLY"	"PLUGGED"	"DISABLED"
`images`	`Image[]`	No	—
`last_updated`	`string (date-time)`	Yes	—

Request example

1{
2  "uid": "3256",
3  "evse_id": "BE*BEC*E041503001",
4  "status": "AVAILABLE",
5  "capabilities": [
6    "RESERVABLE"
7  ],
8  "connectors": [
9    {
10      "id": "1",
11      "standard": "IEC_62196_T2",
12      "format": "CABLE",
13      "power_type": "AC_3_PHASE",
14      "max_voltage": 220,
15      "max_amperage": 16,
16      "tariff_ids": [
17        "11"
18      ],
19      "last_updated": "2015-06-29T21:39:01Z"
20    }
21  ],
22  "last_updated": "2015-06-29T21:39:01Z"
23}

Responses

Status	Description	Schema
`200`	Successful Response	`EvseResponse`
`400`	Invalid or missing parameters (HTTP 200, OCPI envelope)	`—`
`401`	Unauthorized	`—`
`422`	Validation Error	`HTTPValidationError`

`200` — successful response

application/json

Schema: EvseResponse

Field	Type	Required	Description
`status_code`	`integer`	No	Default: `1000`
`status_message`	`string`	No	—
`timestamp`	`string (date-time)`	No	—
`data`	`EVSE`	No	`EVSE`

Response example

1{
2  "status_code": 1000,
3  "status_message": "Success",
4  "timestamp": "2024-01-15T10:00:00Z",
5  "data": {
6    "capabilities": [
7      "RFID_READER",
8      "REMOTE_START_STOP_CAPABLE"
9    ],
10    "connectors": [
11      {
12        "format": "SOCKET",
13        "id": "1",
14        "last_updated": "2024-01-15T10:00:00Z",
15        "max_amperage": 32,
16        "max_voltage": 400,
17        "power_type": "AC_3_PHASE",
18        "standard": "IEC_62196_T2",
19        "tariff_ids": [
20          "TARIFF-001"
21        ]
22      }
23    ],
24    "coordinates": {
25      "latitude": "51.04759",
26      "longitude": "3.72994"
27    },
28    "directions": [
29      {
30        "language": "en",
31        "text": "Near the entrance"
32      }
33    ],
34    "evse_id": "BE-BEC-E041503001",
35    "floor_level": "-1",
36    "images": [],
37    "last_updated": "2024-01-15T10:00:00Z",
38    "parking_restrictions": [
39      "EV_ONLY"
40    ],
41    "physical_reference": "3",
42    "status": "AVAILABLE",
43    "status_schedule": [],
44    "uid": "3256"
45  }
46}

`400` — invalid or missing parameters (HTTP 200, OCPI envelope)

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Invalid or missing parameters",
4  "timestamp": "2025-01-01T00:00:00Z",
5  "doc_url": "https://github.com/ocpplab/ocpi-gateway/blob/main/docs/errors.md#2001-invalid-parameters",
6  "errors": [
7    {
8      "field": "country_code",
9      "message": "expected 'NL' to match Token A identity",
10      "type": "value_error.identity_mismatch"
11    }
12  ]
13}

`401` — unauthorized

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Unauthorized",
4  "timestamp": "2025-01-01T00:00:00Z"
5}

`422` — validation error

application/json

Schema: HTTPValidationError

Field	Type	Required	Description
`detail`	`ValidationError[]`	No	`Detail`

Response example

1{
2  "detail": [
3    {
4      "loc": [],
5      "msg": "string",
6      "type": "string",
7      "input": {
8        "_type": "Input"
9      },
10      "ctx": {
11        "_type": "Context"
12      }
13    }
14  ]
15}

Examples

Shell, Python, and TypeScript (set OCPI_TOKEN when auth is required).

1curl -sS -X PUT 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/locations/NL/ABC/LOC1/EVSE1' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"uid":"3256","evse_id":"BE*BEC*E041503001","status":"AVAILABLE","capabilities":["RESERVABLE"],"connectors":[{"id":"1","standard":"IEC_62196_T2","format":"CABLE","power_type":"AC_3_PHASE","max_voltage":220,"max_amperage":16,"tariff_ids":["11"],"last_updated":"2015-06-29T21:39:01Z"}],"last_updated":"2015-06-29T21:39:01Z"}'

Receiver EVSE

Overview

How to call

Request

Path parameters

Request body

Request example

Responses

`200` — successful response

`400` — invalid or missing parameters (HTTP 200, OCPI envelope)

`401` — unauthorized

`422` — validation error

Examples

Is this helpful?

AI Tools

On this page

Receiver EVSE

Overview

How to call

Request

Path parameters

Request body

Request example

Responses

`200` — successful response

`400` — invalid or missing parameters (HTTP 200, OCPI envelope)

`401` — unauthorized

`422` — validation error

Examples

Is this helpful?

AI Tools

On this page