Skip to main content
GET
Get a participant's operational status

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Path Parameters

id
string
required

Participant id (UUID).

Example:

"0190b5a0-0000-7000-8000-0000000000aa"

Response

OK

ispb
string | null
required

The participant's ISPB (8 characters) — the key the PAG0101 notice arrived under and the key the submission gate evaluates. Null when the participant has no ISPB registered, in which case it can never receive a notice.

Example:

"12345678"

nonOperating
boolean
required

Whether the submission gate blocks this participant. Read with the SAME key (the participant's ISPB) and the SAME predicate the gate uses, so it cannot disagree with it. NO_NOTICE is false — no notice does not block.

Example:

true

previousStatus
enum<string> | null
required

What the PREVIOUS row for this ISPB carried — a REWRITE marker, not a transition. PAG0101 is a recurring full-roster snapshot (at least 2 per business day) and there is no insert-only-on-change guard, so for a stable institution this equals status on essentially every read; a differing value is the exception. Diagnostic only: the submission gate reads status. Null on a first-ever notice or a NO_NOTICE answer.

Available options:
ACTIVE,
SUSPENDED,
SPECIAL_REGIME,
null
Example:

"ACTIVE"

receivedAt
string<date-time> | null
required

When the notice was recorded (RFC3339 UTC); null on a NO_NOTICE answer.

Example:

"2026-08-11T05:50:00Z"

source
string | null
required

Message type the status came from; null on a NO_NOTICE answer.

Example:

"PAG0101"

sourceMessageId
string | null
required

Originating RSFN message id — the value to grep for in the logs to find the notice that caused this status. Null on a NO_NOTICE answer.

Example:

"29011780260628000000050"

status
enum<string>
required

Latest operational status: ACTIVE, SUSPENDED, SPECIAL_REGIME, or NO_NOTICE when the participant exists but no PAG0101 has ever been recorded for it.

Available options:
ACTIVE,
SUSPENDED,
SPECIAL_REGIME,
NO_NOTICE
Example:

"SUSPENDED"