Report Field Validator

List available validation rule sets by org

{
  "data": [
    {
      "ruleset_id": "rules_org_nansen_01_v3",
      "org_id": "org_nansen_01",
      "schema_version": 3,
      "field_count": 9,
      "created_at": "2026-02-15T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Get current validation errors for a specific field

{
  "field_id": "fld_mentor_notes",
  "errors": [
    {
      "code": "conditional_required",
      "message": "Mentor notes are required when participant engagement is 'high' or 'very_high'"
    }
  ]
}

Validate a single field value against its config

{
  "field_config": {
    "field_id": "fld_attendance",
    "type": "number",
    "required": true,
    "min": 0,
    "max": 50
  },
  "value": 53
}

{
  "field_id": "fld_attendance",
  "valid": false,
  "errors": [
    {
      "code": "max_exceeded",
      "message": "Value 53 exceeds maximum of 50"
    }
  ]
}

Validate an entire form (all fields) against a schema

{
  "schema_id": "schema_org_nansen_01",
  "values": {
    "fld_session_date": "2026-03-20",
    "fld_attendance": 6,
    "fld_session_topic": "Job application support",
    "fld_engagement": "high",
    "fld_mentor_notes": ""
  }
}

{
  "schema_id": "schema_org_nansen_01",
  "is_valid": false,
  "errors": {
    "fld_mentor_notes": "Required when engagement level is 'high' or 'very_high'"
  },
  "valid_fields": [
    "fld_session_date",
    "fld_attendance",
    "fld_session_topic",
    "fld_engagement"
  ],
  "invalid_fields": [
    "fld_mentor_notes"
  ]
}

Update a validation ruleset (reserved for schema evolution)

{
  "rules": [
    {
      "field_id": "fld_attendance",
      "type": "number",
      "required": true,
      "min": 0,
      "max": 100
    }
  ]
}

{
  "ruleset_id": "rules_org_nansen_01_v4",
  "schema_version": 4,
  "updated_at": "2026-03-26T10:00:00Z"
}

Delete a validation ruleset

{
  "deleted": true,
  "ruleset_id": "rules_org_nansen_01_v3"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}