CertificationRule

A request or response body; the type column links to the schemas it refers to.

CertificationRule

FieldTypeRequiredDescription
idstring (uuid)yes—
certification_type_idstring (uuid)yes—
rule_kindstringyes

subject_hours: evidenced hours on the type's subjects (or on subject_matter_id alone) must reach threshold_hours. subject_record_count: completed records on the subjects (or on subject_matter_id alone) must reach threshold_count. evidence_document: a completed record on the subject must carry evidence of evidence_type (a pass_fail row counts only when it records a pass). manual_sign_off: a permission holder must record a sign-off for the rule. quiz_pass: the user must have a passing attempt of the quiz named by quiz_id. external_course_pass: the user must have a passing grade of the external LMS course named by external_course_id. scorm_course_complete: the user must have completed the hosted SCORM course named by scorm_course_id. job_aid_viewed: the user must have opened the job aid named by job_aid_id.

one of "subject_hours" | "subject_record_count" | "evidence_document" | "manual_sign_off" | "quiz_pass" | "external_course_pass" | "scorm_course_complete" | "job_aid_viewed"

labelstring | nullyes—
threshold_hoursnumber | nullyes—
threshold_countnumber | nullyes—
evidence_typestring | nullyes

one of "score" | "date_range" | "quantity" | "url" | "file" | "pass_fail" | "note" | null

quiz_idstring (uuid) | nullyes—
external_course_idstring (uuid) | nullyes—
scorm_course_idstring (uuid) | nullyes—
job_aid_idstring (uuid) | nullyes—
subject_matter_idstring (uuid) | nullyes

The one subject a threshold rule counts, when narrowed; null counts every tag of the type, and always null on the other kinds.

created_atstring (date-time)yes—
jsonExample
{
  "id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
  "certification_type_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
  "rule_kind": "subject_hours",
  "label": "string",
  "threshold_hours": 0,
  "threshold_count": 0,
  "evidence_type": "score",
  "quiz_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
  "external_course_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
  "scorm_course_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
  "job_aid_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
  "subject_matter_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
  "created_at": "2026-01-01T00:00:00.000Z"
}