Skip to main content

List bans

GET 

/openapi/v1/bans

Search ban-check records. Filters: workerUrn (full worker/applicant URN the ban belongs to), registry (e.g. AGED_CARE_QUALITY), status (CLEAR, REVIEW_REQUIRED, MATCH_FOUND, CHECK_FAILED, PENDING). Filter by check recency with checkedAfter and/or checkedBefore (ISO 8601 instant, e.g. 2026-01-01T00:00:00Z, or a bare date 2026-01-01); checkedAfter is inclusive, checkedBefore is exclusive. Sort by lastCheckedAt, e.g. sort=lastCheckedAt:desc. Soft-deleted records are excluded by default; pass includeDeleted=true to include them. Each record's attributes.matches lists the matched register rows with their ban tenure (banStartDate/banEndDate; a null end date means the ban is permanent).

Request

Responses

OK