---
title: "Discover Users"
method: GET
path: "/users/discover"
tags: ["users", "users"]
---

# Discover Users

`GET /users/discover`

Discover users for language learning partnerships.

## Query parameters

- `language_filter` string, nullable — Filter by native language
- `learning_filter` string, nullable — Filter by target language
- `search` string, nullable — Search by username, full name, or bio
- `location_search` string, nullable — Search by location
- `gender_filter` string, nullable — Filter by user gender (male, female, non_binary)
- `sort_by` string, nullable — Sort users by field (name, last_active, rating, reviews, recent)
- `online_only` boolean, nullable — Filter to show only online users
- `school_only` boolean, nullable — Only show learners from the viewer's school(s)
- `limit` integer — Number of users to return
- `offset` integer — Number of users to skip

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- UserDiscoveryResponse[]
  - `id` string, uuid, required
  - `username` string, required
  - `full_name` string, nullable, required
  - `profile_picture` string, nullable, required
  - `native_language` string, nullable, required
  - `native_languages` string[]
  - `target_languages` string[], required
  - `profile_data` object, required
  - `interests` string[]
  - `last_login_at` string, date-time, nullable
  - `average_rating` number, nullable
  - `review_count` integer
  - `is_friend` boolean
  - `friend_request_status` string, nullable
  - `account_type` string, nullable
  - `is_staff` boolean
  - `is_ai_persona` boolean
  - `school_name` string, nullable
  - `relationship_status` string, nullable
  - `has_booking_today` boolean
  - `starting_hourly_rate` number, nullable
  - `currency` string, nullable
  - `badge_count` integer

## 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)