Tokens

Driver authorization tokens (RFID / app / virtual idTags)

GET `/tokens` List tokens

Parameters

Name	In	Type	Required	Description
`page`	query	integer
`per_page`	query	integer

Responses

200 Token list

Property Type Required Description

data array<Token>

Property	Type	Required	Description
`id`	string	required
`uid`	string	required	Physical RFID uid / MIFARE / virtual string the charger presents as OCPP idTag. Unique per org.
`type`	enum `rfid` `app` `other`	required
`valid`	boolean	required	Whether this token may currently authorize a charging session.
`label`	stringnullable		Human-friendly label (e.g. driver name).
`issuer_party_id`	stringnullable		OCPI party id of the issuer; null for CPO-native tokens.
`created_at`	stringformat: date-time	required

pagination Pagination

Property	Type	Required
`total`	integer	required
`page`	integer	required
`per_page`	integer	required
`has_more`	boolean	required

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X GET "https://api.ampr.dev/v1/tokens" \
  -H "Authorization: Bearer $AMPR_API_KEY"

const res = await fetch('https://api.ampr.dev/v1/tokens', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
  },
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

POST `/tokens` Pre-register a driver token

Pre-register a driver token (fleet card) into the org allowlist before charger cutover. Strict insert — a duplicate (org, uid) returns 409.

Request body

Property	Type	Required	Description
`uid`	string	required	RFID uid / MIFARE / virtual idTag; non-empty, bounded length + charset.
`type`	enum `rfid` `app` `other`
`valid`	boolean
`label`	string

Responses

201 Token created

Property Type Required Description

data Token

Property	Type	Required	Description
`id`	string	required
`uid`	string	required	Physical RFID uid / MIFARE / virtual string the charger presents as OCPP idTag. Unique per org.
`type`	enum `rfid` `app` `other`	required
`valid`	boolean	required	Whether this token may currently authorize a charging session.
`label`	stringnullable		Human-friendly label (e.g. driver name).
`issuer_party_id`	stringnullable		OCPI party id of the issuer; null for CPO-native tokens.
`created_at`	stringformat: date-time	required

400 Invalid request parameters application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

409 Resource conflict (e.g., duplicate serial, active session) application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X POST "https://api.ampr.dev/v1/tokens" \
  -H "Authorization: Bearer $AMPR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "string",
    "type": "rfid",
    "valid": true,
    "label": "string"
  }'

const res = await fetch('https://api.ampr.dev/v1/tokens', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "uid": "string",
    "type": "rfid",
    "valid": true,
    "label": "string"
  }),
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

GET `/tokens/{token_id}` Get a token

Parameters

Name	In	Type	Required	Description
`token_id`	path	string	required

Responses

200 Token detail

Property Type Required Description

data Token

Property	Type	Required	Description
`id`	string	required
`uid`	string	required	Physical RFID uid / MIFARE / virtual string the charger presents as OCPP idTag. Unique per org.
`type`	enum `rfid` `app` `other`	required
`valid`	boolean	required	Whether this token may currently authorize a charging session.
`label`	stringnullable		Human-friendly label (e.g. driver name).
`issuer_party_id`	stringnullable		OCPI party id of the issuer; null for CPO-native tokens.
`created_at`	stringformat: date-time	required

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

404 Resource not found application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X GET "https://api.ampr.dev/v1/tokens/trk_example" \
  -H "Authorization: Bearer $AMPR_API_KEY"

const res = await fetch('https://api.ampr.dev/v1/tokens/trk_example', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
  },
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

PATCH `/tokens/{token_id}` Update a token

Toggle `valid` (e.g. block a lost card) or edit `label`.

Parameters

Name	In	Type	Required	Description
`token_id`	path	string	required

Request body

Property	Type	Required	Description
`valid`	boolean
`label`	stringnullable

Responses

200 Token updated

Property Type Required Description

data Token

Property	Type	Required	Description
`id`	string	required
`uid`	string	required	Physical RFID uid / MIFARE / virtual string the charger presents as OCPP idTag. Unique per org.
`type`	enum `rfid` `app` `other`	required
`valid`	boolean	required	Whether this token may currently authorize a charging session.
`label`	stringnullable		Human-friendly label (e.g. driver name).
`issuer_party_id`	stringnullable		OCPI party id of the issuer; null for CPO-native tokens.
`created_at`	stringformat: date-time	required

400 Invalid request parameters application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

404 Resource not found application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X PATCH "https://api.ampr.dev/v1/tokens/trk_example" \
  -H "Authorization: Bearer $AMPR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "valid": true,
    "label": "string"
  }'

const res = await fetch('https://api.ampr.dev/v1/tokens/trk_example', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "valid": true,
    "label": "string"
  }),
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

Tokens

GET /tokens List tokens

Parameters

Responses

Request example

POST /tokens Pre-register a driver token

Request body

Responses

Request example

GET /tokens/{token_id} Get a token

Parameters

Responses

Request example

PATCH /tokens/{token_id} Update a token

Parameters

Request body

Responses

Request example

GET `/tokens` List tokens

POST `/tokens` Pre-register a driver token

GET `/tokens/{token_id}` Get a token

PATCH `/tokens/{token_id}` Update a token