Skip to main content
GET
Get token detail

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowClient Credentials
Token URL
https://auth.spirii.dk/realms/public-api/protocol/openid-connect/token

Path Parameters

tokenId
string<uuid>
required

The token id

Response

The token

schema_version
enum<string>
required

Canonical schema version

Available options:
v1
id
string
required

Stable internal token id, commonly a UUIDv7

Maximum string length: 64
tenant_id
string
required

Owning tenant, set by the platform

type
enum<string>
required
Available options:
RFID,
APP_USER,
AD_HOC_USER,
EMAID,
OTHER
uid
string
required

Primary credential identifier, unique within the tenant

Maximum string length: 50
contract_id
string
required

Contract or credential identity, e.g. an eMAID

Maximum string length: 50
issuer
string
required

Issuer name associated with the credential

Maximum string length: 100
whitelist
enum<string>
required

OCPI whitelist policy

Available options:
ALWAYS,
ALLOWED,
ALLOWED_OFFLINE,
NEVER
status
enum<string>
required
Available options:
PROVISIONED,
ACTIVE,
SUSPENDED,
EXPIRED,
REVOKED
whitelist_distributed
boolean
required

Whether the token has been distributed to whitelist-capable CPO networks

created_at
string<date-time>
required

When the token was created in the platform registry

last_updated
string<date-time>
required

Canonical publication timestamp propagated to roaming partners

audit
object
required
country_code
string | null
Required string length: 2
party_id
string | null
Required string length: 3
visual_number
string | null
Maximum string length: 64
language
string | null

Preferred language of the token owner

valid_from
string<date-time> | null
valid_until
string<date-time> | null
group_id
string | null

OCPI token group id used in roaming payloads. Unrelated to Spirii EMSP token groups

Maximum string length: 50
emsp_group_id
string | null

Primary Spirii EMSP token group, set at provision time. A convenience only: membership is many-to-many and is managed through POST /emsp/v1/token-groups/{groupId}/tokens

Maximum string length: 50
metadata
object | null

Name/value pairs validated against the tenant's active TOKEN metadata schema

last_authorization
string<date-time> | null
invalidated_at
string<date-time> | null