Skip to main content
POST
Register an EMP identity

Headers

Idempotency-Key
string<uuid>
required

Client-generated unique key per operation intent (UUID). Same key + identical body replays the original response; same key + different body returns 409.

Body

application/json
country_code
string
required

The two-letter country this identity operates in (for example, DK for Denmark). ISO 3166-1 alpha-2 country code

Pattern: ^[A-Z]{2}$
Example:

"DK"

party_id
string
required

The short three-character code that identifies your organization in roaming. OCPI party_id (3-character code)

Pattern: ^[A-Z0-9]{3}$
Example:

"SPR"

protocol
enum<string>[]

Roaming protocols this identity uses — one or more of OCPI or OICP. Omit the field if not yet known; do not send null or an empty array.

Minimum array length: 1
Available options:
OCPI,
OICP
label
string | null

A name to help you recognize this identity.

Maximum string length: 255
contact_email
string<email>

A contact email for this identity.

contact_phone
string | null

A contact phone number for this identity.

Maximum string length: 20
default_network_access
boolean
default:true

Whether this identity can see all published networks by default. Defaults to yes.

Response

emp_identity_id
string<uuid>
required

Platform-assigned stable identifier

country_code
string
required

ISO 3166-1 alpha-2 country code

Pattern: ^[A-Z]{2}$
Example:

"DK"

party_id
string
required

OCPI party_id (3-character code)

Pattern: ^[A-Z0-9]{3}$
Example:

"SPR"

status
enum<string>
required
Available options:
ACTIVE,
SUSPENDED
created_at
string<date-time>
required
protocol
enum<string>[]
Available options:
OCPI,
OICP
label
string | null

Optional human-readable label

Maximum string length: 255
contact_email
string<email>
contact_phone
string | null
Maximum string length: 20
default_network_access
boolean
default:true

Whether this identity grants visibility into all Published Base Networks