---
title: "Find Lesson Partners"
method: GET
path: "/lessons/match-partners"
tags: ["lessons", "lessons"]
---

# Find Lesson Partners

`GET /lessons/match-partners`

Find potential practice partners who have completed the same lesson.
Matches based on:
- Same passage/topic
- Similar CEFR level (±1 level)
- Complementary languages (they speak user's target language, or vice versa)
- Recently completed the lesson (within last 7 days)

## Query parameters

- `passage_id` string, uuid, required — Passage ID to find partners for
- `limit` integer — Maximum number of partners to return

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- PartnerMatchResponse[]
  - `user_id` string, uuid, required
  - `username` string, required
  - `full_name` string, nullable
  - `profile_picture` string, nullable
  - `native_languages` string[], required
  - `target_languages` string[], required
  - `match_score` number, required
  - `match_reasons` object[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/45cbba31aa7d/schema)