Skip to main content
GET
Get current enrollment status

Authorizations

Authorization
string
header
required

Bearer token authentication, for client-server calls.

Send the access token issued by POST /v1/auth/token as Authorization: Bearer {token}. The token carries its own program and user context, so the X-Meridian-* headers are not required. See Authentication.

Headers

X-Meridian-Api-Key
string

Server-to-server (HMAC) requests only. Partner API key issued by Meridian during provisioning.

X-Meridian-Timestamp
string

Server-to-server (HMAC) requests only. Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request.

X-Meridian-Program-Id
string

Server-to-server (HMAC) requests only. Identifies the program context for the request.

X-Meridian-User-Id
string

Server-to-server (HMAC) requests only. Identifies the Meridian user targeted by the request. Required for MULTI_USER integrations; omit for SINGLE_USER.

Response

The current or freshly-created enrollment for the authenticated account

Enrollment state for the authenticated Meridian account

id
string
required

Unique identifier of the enrollment

Example:

"enrollment_123"

createdAt
string<date-time>
required

Timestamp when the enrollment was created

Example:

"2026-04-01T12:00:00Z"

updatedAt
string<date-time>
required

Timestamp when the enrollment was last updated

Example:

"2026-04-01T12:05:00Z"

status
enum<string>
required

Current status of the enrollment

Available options:
INACTIVE,
ACTIVE
Example:

"ACTIVE"

statusReason
enum<string> | null

Reason for the current enrollment status, when one applies

Available options:
REVOKED,
ACTIVATION_REJECTED,
null
Example:

"ACTIVATION_REJECTED"

statusReasonMessage
string | null

Human-readable detail for the current status reason, when one applies

Example:

"An identity document is required for the associated person."

latestInformationRequest
Information Request Summary · object | null

Summary Information Request entry for the authenticated Meridian account