Get an actor mapping

Use this endpoint to retrieve the display name and email mapped to a specific actor identifier.

GET /v1/governance/actor-mappings/{actorId}

Get an actor mapping

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/governance/actor-mappings/{actorId} \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "actorId": "user:550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-01-15T10:30:00Z",
  "displayName": "John Doe",
  "email": "[e-mail]"
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

Parámetros de ruta

actorId · string · requerido

The actor identifier. Actor ID

Respuesta

200

application/json

Successfully retrieved actor mapping

actorId · string · requerido

Opaque actor identifier the PII mapping is keyed on

Ejemplo:

"user:550e8400-e29b-41d4-a716-446655440000"

createdAt · string · requerido

Timestamp when the mapping was created, in RFC 3339 format (UTC)

Ejemplo:

"2026-01-15T10:30:00Z"

updatedAt · string · requerido

Timestamp when the mapping was last updated, in RFC 3339 format (UTC)

Ejemplo:

"2026-01-15T10:30:00Z"

displayName · string

Human-readable display name for the actor; absent when not set or after pseudonymization

Ejemplo:

"John Doe"

email · string

Email address of the actor; absent when not set or after pseudonymization

Ejemplo:

"[e-mail]"