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
- 200
- 401
- 403
- 429
- 500
OK
Authentication required
Caller is not authorised
Rate limit exceeded — see Retry-After header
Internal server error