Matches

Returns match quality tier and belonging components. Access verified for the match member or organisation.

{
  "id": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
  "member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "org_id": "e1f2a3b4-c5d6-7890-efab-cdef12345678",
  "match_quality": "strong",
  "match_status": "pending_review",
  "computed_at": "2026-03-08T09:00:00Z"
}

Returns human-readable match explanation with top strengths, growth areas, and belonging breakdown. Generates asynchronously if not cached (returns 202).

{
  "match_id": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
  "top_strengths": [
    "Exceptional pressure response",
    "Strong collaborative orientation"
  ],
  "growth_areas": [
    "Developing strategic thinking under ambiguity"
  ],
  "belonging_breakdown": {
    "authenticity": "high",
    "acceptance": "strong",
    "complementarity": "moderate"
  },
  "confidence_statement": "High confidence based on comprehensive identity data.",
  "summary_text": "Strong alignment with the team culture, particularly in collaborative problem-solving."
}

Update match status (organisation action). Requires org_admin or platform_admin role.

{
  "status": "org_interested"
}

Record a placement outcome for the RL feedback loop. Requires org_admin or platform_admin role.

Queue match computation for a job (optionally for a specific member). Returns 202 Accepted with task ID.

List all matches for a member. Cursor-paginated. Members can view own; admins can view any.

List all matches for a job. Cursor-paginated with quality and status filters. Org or admin access.

Submit post-placement feedback at 30/90/180-day intervals. Both members and organisations can submit. One submission per respondent per stage.

List all feedback records for a match. Accessible to match participants and admins.