OpenAPI reference

Receiver Token

PUT/tokens/{country_code}/{party_id}/{token_uid}

Push a new or updated Token object from the eMSP to the CPO. PUT is full-replace per OCPI 2.2.1 §14.4.2 — omitted fields reset to their schema defaults. Path `token_uid` and query `type` (defaulting t

API: OCPI 2.2.1 (CPO) · Module: Tokens (CPO)
Base path: /tokens · Base URL: https://ocpi-api.gridos.co/ocpi/cpo/2.2.1

Overview

PUT /tokens/{country_code}/{party_id}/{token_uid}

Absolute URL: https://ocpi-api.gridos.co/ocpi/cpo/2.2.1/tokens/{country_code}/{party_id}/{token_uid}

Push a new or updated Token object from the eMSP to the CPO. PUT is full-replace per OCPI 2.2.1 §14.4.2 — omitted fields reset to their schema defaults. Path token_uid and query type (defaulting to the body type, then RFID) identify the Token.

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/cpo/2.2.1/tokens/NL/ABC/TOKEN123' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"country_code":"NL","party_id":"TNM","uid":"100012","type":"RFID","contract_id":"NL-TNM-000100012","visual_number":"DF000-2001-8999","issuer":"TheNewMotion","group_id":"NL-TNM-GRP001","valid":true,"whitelist":"ALWAYS","language":"nl","default_profile_type":"GREEN","last_updated":"2015-06-21T22:39:05Z"}'

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).
`token_uid`	`string`	Yes	Token.uid of the Token.

Query parameters

Name	Type	Required	Description
`type`	`TokenType`	No	Token.type, defaults to RFID if not provided.

Request body

application/json · Required

Schema: TokenCreate

Field	Type	Required	Description
`country_code`	`string`	Yes	—
`party_id`	`string`	Yes	—
`uid`	`string`	Yes	Unique ID by which this Token can be identified.
`type`	`"AD_HOC_USER"	"APP_USER"	"RFID"
`contract_id`	`string`	Yes	Uniquely identifies the driver contract.
`visual_number`	`string`	No	—
`issuer`	`string`	Yes	Issuing company, usually the connected eMSP.
`group_id`	`string`	No	—
`valid`	`boolean`	Yes	—
`whitelist`	`"ALWAYS"	"ALLOWED"	"ALLOWED_OFFLINE"
`language`	`string`	No	—
`default_profile_type`	`"CHEAP"	"FAST"	"GREEN"
`energy_contract`	`object`	No	—
`last_updated`	`string (date-time)`	Yes	—

Request examples

Example 1

1{
2  "country_code": "NL",
3  "party_id": "TNM",
4  "uid": "100012",
5  "type": "RFID",
6  "contract_id": "NL-TNM-000100012",
7  "visual_number": "DF000-2001-8999",
8  "issuer": "TheNewMotion",
9  "group_id": "NL-TNM-GRP001",
10  "valid": true,
11  "whitelist": "ALWAYS",
12  "language": "nl",
13  "default_profile_type": "GREEN",
14  "last_updated": "2015-06-21T22:39:05Z"
15}

Example 2

1{
2  "country_code": "DE",
3  "party_id": "EMP",
4  "uid": "APP-22",
5  "type": "APP_USER",
6  "contract_id": "DE-EMP-C-7788",
7  "issuer": "Example Mobility",
8  "valid": true,
9  "whitelist": "ALLOWED",
10  "last_updated": "2015-06-23T08:00:00Z"
11}

Responses

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

`200` — successful response

application/json

Schema: TokenResponse

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

Response example

1{
2  "status_code": 1000,
3  "status_message": "Success",
4  "timestamp": "2024-01-15T10:00:00Z",
5  "data": {
6    "contract_id": "NL-TNM-012345678905880-S",
7    "country_code": "NL",
8    "default_profile_type": "GREEN",
9    "energy_contract": {
10      "contract_id": "ENERGY-CONTRACT-001",
11      "supplier_name": "Greenchoice"
12    },
13    "group_id": "GROUP-001",
14    "issuer": "MobilityPlus",
15    "language": "nl",
16    "last_updated": "2024-01-15T10:00:00Z",
17    "party_id": "TNM",
18    "type": "RFID",
19    "uid": "012345678905880",
20    "valid": true,
21    "visual_number": "DF000-2001-8999-1",
22    "whitelist": "ALLOWED"
23  }
24}

`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/cpo/2.2.1/tokens/NL/ABC/TOKEN123' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"country_code":"NL","party_id":"TNM","uid":"100012","type":"RFID","contract_id":"NL-TNM-000100012","visual_number":"DF000-2001-8999","issuer":"TheNewMotion","group_id":"NL-TNM-GRP001","valid":true,"whitelist":"ALWAYS","language":"nl","default_profile_type":"GREEN","last_updated":"2015-06-21T22:39:05Z"}'

OpenAPI reference

Receiver Token

PUT/tokens/{country_code}/{party_id}/{token_uid}

API: OCPI 2.2.1 (CPO) · Module: Tokens (CPO)
Base path: /tokens · Base URL: https://ocpi-api.gridos.co/ocpi/cpo/2.2.1

Overview

PUT /tokens/{country_code}/{party_id}/{token_uid}

Absolute URL: https://ocpi-api.gridos.co/ocpi/cpo/2.2.1/tokens/{country_code}/{party_id}/{token_uid}

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/cpo/2.2.1/tokens/NL/ABC/TOKEN123' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"country_code":"NL","party_id":"TNM","uid":"100012","type":"RFID","contract_id":"NL-TNM-000100012","visual_number":"DF000-2001-8999","issuer":"TheNewMotion","group_id":"NL-TNM-GRP001","valid":true,"whitelist":"ALWAYS","language":"nl","default_profile_type":"GREEN","last_updated":"2015-06-21T22:39:05Z"}'

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).
`token_uid`	`string`	Yes	Token.uid of the Token.

Query parameters

Name	Type	Required	Description
`type`	`TokenType`	No	Token.type, defaults to RFID if not provided.

Request body

application/json · Required

Schema: TokenCreate

Field	Type	Required	Description
`country_code`	`string`	Yes	—
`party_id`	`string`	Yes	—
`uid`	`string`	Yes	Unique ID by which this Token can be identified.
`type`	`"AD_HOC_USER"	"APP_USER"	"RFID"
`contract_id`	`string`	Yes	Uniquely identifies the driver contract.
`visual_number`	`string`	No	—
`issuer`	`string`	Yes	Issuing company, usually the connected eMSP.
`group_id`	`string`	No	—
`valid`	`boolean`	Yes	—
`whitelist`	`"ALWAYS"	"ALLOWED"	"ALLOWED_OFFLINE"
`language`	`string`	No	—
`default_profile_type`	`"CHEAP"	"FAST"	"GREEN"
`energy_contract`	`object`	No	—
`last_updated`	`string (date-time)`	Yes	—

Request examples

Example 1

1{
2  "country_code": "NL",
3  "party_id": "TNM",
4  "uid": "100012",
5  "type": "RFID",
6  "contract_id": "NL-TNM-000100012",
7  "visual_number": "DF000-2001-8999",
8  "issuer": "TheNewMotion",
9  "group_id": "NL-TNM-GRP001",
10  "valid": true,
11  "whitelist": "ALWAYS",
12  "language": "nl",
13  "default_profile_type": "GREEN",
14  "last_updated": "2015-06-21T22:39:05Z"
15}

Example 2

1{
2  "country_code": "DE",
3  "party_id": "EMP",
4  "uid": "APP-22",
5  "type": "APP_USER",
6  "contract_id": "DE-EMP-C-7788",
7  "issuer": "Example Mobility",
8  "valid": true,
9  "whitelist": "ALLOWED",
10  "last_updated": "2015-06-23T08:00:00Z"
11}

Responses

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

`200` — successful response

application/json

Schema: TokenResponse

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

Response example

1{
2  "status_code": 1000,
3  "status_message": "Success",
4  "timestamp": "2024-01-15T10:00:00Z",
5  "data": {
6    "contract_id": "NL-TNM-012345678905880-S",
7    "country_code": "NL",
8    "default_profile_type": "GREEN",
9    "energy_contract": {
10      "contract_id": "ENERGY-CONTRACT-001",
11      "supplier_name": "Greenchoice"
12    },
13    "group_id": "GROUP-001",
14    "issuer": "MobilityPlus",
15    "language": "nl",
16    "last_updated": "2024-01-15T10:00:00Z",
17    "party_id": "TNM",
18    "type": "RFID",
19    "uid": "012345678905880",
20    "valid": true,
21    "visual_number": "DF000-2001-8999-1",
22    "whitelist": "ALLOWED"
23  }
24}

`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/cpo/2.2.1/tokens/NL/ABC/TOKEN123' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"country_code":"NL","party_id":"TNM","uid":"100012","type":"RFID","contract_id":"NL-TNM-000100012","visual_number":"DF000-2001-8999","issuer":"TheNewMotion","group_id":"NL-TNM-GRP001","valid":true,"whitelist":"ALWAYS","language":"nl","default_profile_type":"GREEN","last_updated":"2015-06-21T22:39:05Z"}'

Receiver Token

Overview

How to call

Request

Path parameters

Query parameters

Request body

Request examples

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 Token

Overview

How to call

Request

Path parameters

Query parameters

Request body

Request examples

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