canonical

List subjects

Read a bounded list of non-deleted subjects visible in this environment.

get/api/v1/subjects

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
Auth
HTTP bearer

limitinteger

Maximum records requested; default 100. The service bounds it to 1-500. No cursor pagination is exposed.

Array of visible non-deleted subject records, up to the effective limit.

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.

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