---
title: "Typesense-ranked search over public enthusiasts (falls back to SQL)"
method: GET
path: "/v1/enthusiasts/search"
tags: ["Public Enthusiasts"]
---

# Typesense-ranked search over public enthusiasts (falls back to SQL)

`GET /v1/enthusiasts/search`

## Request

- Base URL: `https://api.vendure.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.vendure.io/v1/enthusiasts/search`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vendure/apis/vendure-io-api-public/docs/v1/enthusiasts/search/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `page` number
- `pageSize` number
- `q` string, required
- `sort` 'vxp' | 'name' | 'newest'

## Response `200`

- PagedEnthusiastPublicDto
  - `items` EnthusiastPublicDto[], required
    - `id` string, uuid, required
    - `firstName` string, nullable, required
    - `lastName` string, nullable, required
    - `githubUsername` string, nullable, required
    - `avatarUrl` string, nullable, required: Public URL of the uploaded avatar. `null` when the user has not uploaded one.
    - `bio` string, nullable, required
    - `personalVxp` number, required
    - `enthusiastSince` string, date-time, nullable, required
    - `socialLinks` object, nullable, required: Key-value map of social links
    - `partnerName` string, nullable, required
    - `partnerSlug` string, nullable, required
    - `partnerTier` 'NONE' | 'FRIEND' | 'PARTNER_PENDING' | 'PARTNER', nullable, required
  - `total` number, required: Total number of items matching the query
  - `page` number, required: Current page (1-based)
  - `pageSize` number, required: Items per page

## Other responses

- `400`: Validation failed
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `500`: Internal server error

## Changes

- **2026-08-24** `d1eeb97df5f6`: 1 info
  - added the required property `items/items/avatarUrl` to the response with the `200` status

[Operation history](https://skmtc.dev/vendure/apis/vendure-io-api-public/changes/v1/enthusiasts/search/get.md)

---

[API](https://skmtc.dev/vendure/apis/vendure-io-api-public.md) - [All operations](https://skmtc.dev/vendure/apis/vendure-io-api-public/llms.txt) - [OpenAPI document](https://skmtc.dev/vendure/apis/vendure-io-api-public/revisions/0747ce439f89?raw)