GRgraypass
canonical

Read a subject

Retrieve the current subject enrollment and recovery state before starting a lifecycle operation.

get/api/v1/subjects/{subject_id}

Request

  • Base URL
    https://app.graypass.org (the document declares no server; this is the origin it was published from)
  • URL
    https://app.graypass.org/api/v1/subjects/{subject_id}
  • Auth
    HTTP bearer

Path parameters

subject_idstring required

Subject identifier resolved from your authenticated account mapping.

Response

Current subject state, declared anchor, recovery policy and limitations.

adaptation_frozenboolean required

Whether online template adaptation is frozen; true prevents silent template adaptation.

anchorstring required

Account anchor established by the customer identity process and recorded by GrayPass.

created_atstring required

Creation time as an ISO 8601 timestamp.

enrollment_state'not_enrolled' | 'enrolling' | 'enrolled' | 'revoked' | 'deleted' required

Current enrollment lifecycle state. Revoked subjects need the configured recovery path; deleted subjects are no longer operationally retrievable.

environmentstring required

Environment identifier that scopes this record; sandbox and live resources are separate.

idstring required

Identifier of this record. Treat it as opaque and retain it for subsequent operations.

limitationsstring[]

Applicable limitations that must accompany interpretation of the result.

recovery_policystring required

Recovery rule governing whether re-enrollment requires an anchor or a separate manual-review process.

revoked_atstring nullable

Revocation time as an ISO 8601 timestamp, or null when not revoked.

Changes

No recorded changes to this operation across all 1 revision of this API.