API reference · Enrolment
Read enrolment status
GET
/v1/enrollments/{invitationId}/statusWhere the key stands: waiting for proof, waiting for Anis staff, active, or no longer available.
PermissionNone
AuthenticationEnrolment token
Staff-set limits it counts towardNone
.NET SDK
enrollment.GetStatusAsync()Parameters
| Name | In | Type | Notes |
|---|---|---|---|
invitationIdrequired | path | UUID | A UUID, lower-case with hyphens. |
Request
Authorised with Authorization: Enrollment <token>; not signed.
Headers: Accept-Language (optional). The SDKs set all of them for you.
Body: none.
Responses
| Status | Meaning | Body |
|---|---|---|
| 200 | Success. | EnrollmentStatus |
| 401 | Refused: not authenticated. | Problem |
| 404 | Refused: not found, or not yours. | Problem |
| 429 | Refused: a limit was reached. | Problem |
| 503 | No decision: a dependency was unavailable. | Problem |
Every answer is signed by Anis; the SDKs check it before you see it.
Refusals
Every refusal is a signed problem. Branch on its code; each links to what it means and what to do.
| Error | Code | Status |
|---|---|---|
| Invitation invalid | invitation_invalid | 401 |
| Not found | resource_not_found | 404 |
| Rate limited | rate_limited | 429 |
| Service unavailable | dependency_unavailable | 503 |
| Request timeout | request_timeout | 504 |
| Internal error | internal_error | 500 |
Types
EnrollmentStatus
| Field | Type | Notes |
|---|---|---|
keyId | UUID | Your key id. |
challengeGeneration | integer | The current challenge generation. |
proofState | string | pending, accepted or failed — a proof that did not verify or came too late. After five failed proofs, ask Anis staff to restart the enrolment. |
approvalState | string | pending while Anis staff have not confirmed the key, approved once it is active, notApplicable otherwise. |
state | string | pendingProof, pendingApproval, active — the key signs requests — or unavailable (revoked, expired or replaced). |
expiresAt | string (date-time) | When the current step expires. |