Skip to content

List items recertification

GET /api/v1/recertify/items: request fields and declared response contract.

GET/api/v1/recertify/items

Authorization
Permissionrecertify.list
Workspace scoperequired
Scope targetworkspace

Parameters

Path parameters: none.

Query parameters
FieldTypeRequiredNullableDefault
campaignIdstringoptionalnon-null—
status"pending" | "recertified" | "revoked" | "lapsed" | "deferred"optionalnon-null—
limitintegeroptionalnon-null200

Response

200

Response fields
FieldTypeRequiredNullableDefault
dataarrayrequirednon-null—

Declared failures

Declared failures
RECERTIFY_LIST_FAILED500 — not retryable

Readback

This method returns the current state it read.

  • recertify.list

Request example

Schematic only. Replace placeholders with real values and include all required nested fields.

GET /api/v1/recertify/items HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>