The payroll layer, documented.

Request body (optional)

201 → data: { token, expires_in, role, scope }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { mode, user, role, scope, components, employee_id } · caller context decoded from the token (no DB read) — backs the SDK scope-aware UX

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { stats, tenant_count, generated_at, errored_tenants }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { draft, approved, blocked, finalised }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · per-client status row: id, name, country, site_count, workers, gross_mtd, currency, risk, health, in_flight, next_pay_date, days_until_pay

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Request body

201 → data: { tenant, binding }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, slug, name, jurisdiction, group } · paginated (has_more, next_cursor)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { tenant, bindings }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { code, jurisdiction, name, current_version }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { code, jurisdiction, name, current_version }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { binding_id, engine, role, pinned_version, pack, capabilities, capability_basis, capability_grant_state } · active engine binding + the regulation pack it pins

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · CAPABILITY_NOT_SUPPORTED 501 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · company/organisation details (engine-shaped) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · employer disbursement account (engine-shaped: account name, BSB, account number…) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: object (open) · engine write result · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { code, name, parent_code, gl_account, site, status }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

201 → data: { code, name, parent_code, gl_account, site, status } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { code, name, parent_code, gl_account, site, status } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { code, status } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

200 → data: { employee_id, cost_centre_code } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { employee_id, cost_centre_code } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, source, attribute, match_value, cost_centre_code, priority }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

201 → data: { id, source, attribute, match_value, cost_centre_code, priority } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { id, deleted } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls) · paginated (has_more, next_cursor)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

201 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · tax section as the engine holds it (attested flags, never raw PII) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · bank section as the engine holds it (attested flags, never raw account numbers) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · super/pension section as the engine holds it · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, first_name, last_name, status, employment, statutory, jurisdiction_data } · Canonical cross-country employee. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { jurisdiction, tabs, blocks_finalise, unverified_requirements } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { jurisdiction, tabs, blocks_finalise, unverified_requirements } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Request body

201 → data: { id, employee_id, employee_name, leave_type, start_date, end_date, quantity, unit, reason, … } · Control-plane leave request (never touches the engine until approved). · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, employee_id, employee_name, leave_type, start_date, end_date, quantity, unit, reason, … } · Control-plane leave request (never touches the engine until approved). · paginated (has_more, next_cursor)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { id, employee_id, employee_name, leave_type, start_date, end_date, quantity, unit, reason, … } · Control-plane leave request (never touches the engine until approved). · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, employee_id, employee_name, leave_type, start_date, end_date, quantity, unit, reason, … } · Control-plane leave request (never touches the engine until approved). · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Request body (optional)

200 → data: { id, employee_id, employee_name, leave_type, start_date, end_date, quantity, unit, reason, … } · Control-plane leave request (never touches the engine until approved). · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Request body (optional)

200 → data: { id, employee_id, employee_name, leave_type, start_date, end_date, quantity, unit, reason, … } · Control-plane leave request (never touches the engine until approved). · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { code, name, category, paid, unit, source } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

201 → data: object (open) · created/assigned company leave type (id, name, master_id) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { employee_id, employee_name, leave_type, accrued, taken, balance, unit } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

201 → data: { ok } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

201 → data: { booked, employee_id, leave_type, unit, quantity, start_date, end_date, evidence_id } · The canonical booking receipt — identical across engines (AU pay-item line, DE absence case). · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, employee_id, employee_name, leave_type, unit, quantity, start_date, end_date, status } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: object (open) · cancellation result (id, status) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { booked, employee_id, leave_type, unit, quantity, start_date, end_date, evidence_id } · The canonical booking receipt — identical across engines (AU pay-item line, DE absence case). · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

201 → data: { id, kind, status, period_start, period_end, payment_date, source, engine_status, totals } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, kind, status, period_start, period_end, payment_date, source, engine_status, totals } · paginated (has_more, next_cursor)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { id, kind, status, period_start, period_end, payment_date, source, engine_status, totals } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { ok } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { findings, summary, source, source_freshness, freshness }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

200 → data: object (open) · governed-adjustment result — platform verdict (pass / needs_ack / block), per-item outcomes, evidence refs

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

200 → data: object (open) · governed-adjustment result — platform verdict (pass / needs_ack / block), per-item outcomes, evidence refs

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, employee_id, employee_name, gross, tax, net, statutory, pay_items } · One employee line on a run. · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

201 → data: { ok } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { ok } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { ok } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { pay_run, entries, validation } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, kind, status, period_start, period_end, payment_date, source, engine_status, totals } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, kind, status, period_start, period_end, payment_date, source, engine_status, totals } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: { id, kind, status, period_start, period_end, payment_date, source, engine_status, totals } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

201 → data: { id, kind, status, period_start, period_end, payment_date, source, engine_status, totals } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

200 → data: { ok } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Request body (optional)

200 → data: { pack, gross, net, provenance } · stateless calculation result

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · CAPABILITY_NOT_SUPPORTED 501 · plus 401/403/404 isolation — see Errors.

Request body (optional)

Errors (501 / 4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · CAPABILITY_NOT_SUPPORTED 501 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: object (open) · statutory lodgement record (submission id, status, authority response) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · statutory lodgement record (submission id, status, authority response) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · statutory lodgement record (submission id, status, authority response) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · statutory lodgement record (submission id, status, authority response) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, employee_id, employee_name, gross, net, cost_centre, lines, pdf } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · vendor payment-file payload — ABA file text or a structured object; null when the engine has no payment-file capability · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Request body (optional)

201 → data: { token, expires_in }

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body (optional)

200 → data: object (open) · super batch record (engine shape) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · super obligations overview (header, summary, per-employee rows) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · super batch (engine-shaped: id, description, period, totalAmount, status) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · status-history entry (engine-shaped) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Governed write. Requires governance_reason (body) or the x-governance-reason header — bound into the evidence chain; the response carries evidence_id (cev_).

Request body

200 → data: object (open) · the transitioned batch (engine-shaped) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — governance_reason_required 400 · bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · governed-evidence envelope (cev_ id, actor, operation, hash chain)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · governance-plane audit event · paginated (has_more, next_cursor)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

Request body (optional)

200 → data: object (open) · provider chain-verification result: valid (boolean), length, broken_at?

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · award rate scale (code, name, country, industry, levels[] with base/penalty rates)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · activity summary (gross/net/tax/super totals, by_cost_centre[] breakdown) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · activity period point (period_start/end, payment_date, status, gross/net/tax/super, currency, employee_count) · evidence_id (cev_ receipt on governed calls) · paginated (has_more, next_cursor)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · regulation case definition (name, fields, type-codes) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · case name → field definitions map · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: object (open) · case name → case detail map · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: { matches, all_case_fields, employees_scanned } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of object (open) · L1 master pay-item type template (engine-shaped) · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.

200 → data: array of { id, name, taxable, accrues_super, active, pay_item_type_id } · evidence_id (cev_ receipt on governed calls)

Errors (4XX / 5XX): { error: { code, message, status, errors[] } } — bad_request 400 · state_conflict 409 · pack_validation_failed 422 · plus 401/403/404 isolation — see Errors.