Badge Criteria Integration

List all recruitment badge definitions (getRecruitmentBadgeDefinitions)

{
  "data": [
    {
      "id": "badge_recruiter_bronze",
      "name": "Recruiter — Bronze",
      "description": "Successfully recruited 1 new member",
      "category": "recruitment",
      "required_recruitments": 1,
      "icon_url": "https://cdn.org.no/badges/recruiter-bronze.png",
      "is_active": true,
      "created_at": "2025-09-01T00:00:00Z"
    },
    {
      "id": "badge_recruiter_silver",
      "name": "Recruiter — Silver",
      "description": "Successfully recruited 5 new members",
      "category": "recruitment",
      "required_recruitments": 5,
      "icon_url": "https://cdn.org.no/badges/recruiter-silver.png",
      "is_active": true,
      "created_at": "2025-09-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5
  }
}

Get a badge definition by ID

{
  "id": "badge_recruiter_bronze",
  "name": "Recruiter — Bronze",
  "description": "Successfully recruited 1 new member",
  "category": "recruitment",
  "required_recruitments": 1,
  "icon_url": "https://cdn.org.no/badges/recruiter-bronze.png",
  "is_active": true,
  "created_at": "2025-09-01T00:00:00Z"
}

Create a new badge definition

{
  "name": "Recruiter — Gold",
  "description": "Successfully recruited 10 new members",
  "category": "recruitment",
  "required_recruitments": 10,
  "icon_url": "https://cdn.org.no/badges/recruiter-gold.png",
  "is_active": true
}

{
  "id": "badge_recruiter_gold",
  "name": "Recruiter — Gold",
  "description": "Successfully recruited 10 new members",
  "category": "recruitment",
  "required_recruitments": 10,
  "icon_url": "https://cdn.org.no/badges/recruiter-gold.png",
  "is_active": true,
  "created_at": "2026-03-26T12:00:00Z"
}

Update a badge definition

{
  "required_recruitments": 12,
  "is_active": true
}

{
  "id": "badge_recruiter_gold",
  "name": "Recruiter — Gold",
  "description": "Successfully recruited 10 new members",
  "category": "recruitment",
  "required_recruitments": 12,
  "icon_url": "https://cdn.org.no/badges/recruiter-gold.png",
  "is_active": true,
  "updated_at": "2026-03-26T12:05:00Z"
}

Delete a badge definition

{
  "id": "badge_recruiter_gold",
  "deleted": true,
  "deleted_at": "2026-03-26T12:10:00Z"
}

Evaluate badge criteria for a mentor (evaluateBadgeCriteria)

{
  "mentor_id": "usr_4491"
}

{
  "mentor_id": "usr_4491",
  "total_recruitments": 5,
  "eligible_badges": [
    "badge_recruiter_bronze",
    "badge_recruiter_silver"
  ],
  "already_awarded": [
    "badge_recruiter_bronze"
  ],
  "newly_eligible": [
    "badge_recruiter_silver"
  ],
  "evaluated_at": "2026-03-26T12:00:00Z"
}

Trigger a badge award for a mentor (triggerBadgeAward)

{
  "mentor_id": "usr_4491",
  "badge_id": "badge_recruiter_silver",
  "recruitment_count": 5
}

{
  "award_id": "award_7d9e2f",
  "mentor_id": "usr_4491",
  "badge_id": "badge_recruiter_silver",
  "badge_name": "Recruiter — Silver",
  "awarded_at": "2026-03-26T12:01:00Z",
  "notification_sent": true
}

Notify badge system of confirmed recruitment (onRecruitmentConfirmed)

{
  "mentor_id": "usr_4491",
  "recruitment_count": 5
}

{
  "mentor_id": "usr_4491",
  "recruitment_count": 5,
  "badges_triggered": [
    "badge_recruiter_silver"
  ],
  "processed_at": "2026-03-26T12:01:00Z"
}

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