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

# Discover Users

`GET /users/discover/paginated`

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

- PaginatedUserDiscoveryResponse
  - `users` UserDiscoveryResponse[], required
    - `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
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `has_more` boolean, 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/78f314acd8bf/schema)