Recognition Tier Repository

Fetch all tier definitions for an organisation (internal — proxied via recognition-tier-service)

{
  "data": [
    {
      "id": "tier-bronze",
      "organisation_id": "org-nhf-oslo",
      "name": "Bronze Mentor",
      "level": 1,
      "min_badges_required": 2,
      "is_active": true
    },
    {
      "id": "tier-silver",
      "organisation_id": "org-nhf-oslo",
      "name": "Silver Mentor",
      "level": 2,
      "min_badges_required": 5,
      "is_active": true
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3
  }
}

Get the active tier assignment record for a user

{
  "id": "tier-assign-041",
  "tier_id": "tier-silver",
  "user_id": "pm-kari-001",
  "awarded_at": "2026-03-26T14:30:00Z",
  "awarded_by": "system",
  "revoked_at": null,
  "is_active": true
}

Persist a new tier assignment record

{
  "tier_id": "tier-silver",
  "user_id": "pm-kari-001",
  "awarded_at": "2026-03-26T14:30:00Z",
  "awarded_by": "system"
}

{
  "id": "tier-assign-041",
  "tier_id": "tier-silver",
  "user_id": "pm-kari-001",
  "awarded_at": "2026-03-26T14:30:00Z",
  "awarded_by": "system",
  "revoked_at": null,
  "is_active": true
}

Delete (revoke) a tier assignment record

{
  "id": "tier-assign-041",
  "deleted": true,
  "deleted_at": "2026-03-26T15:00:00Z"
}

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