---
title: "Roster"
method: POST
path: "/api/v1/remy/preview/roster/search"
tags: ["remy"]
---

# Roster

`POST /api/v1/remy/preview/roster/search`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/remy/preview/roster/search`
- Auth: HTTP bearer

## Request body

- RosterSearch
  - `search` string, nullable
  - `followers` string[], nullable
  - `engagement_rate_min` number, nullable
  - `language` string[], nullable
  - `category` string[], nullable
  - `subcategory` string[], nullable
  - `followership` string[], nullable
  - `platform` string[], nullable
  - `location` string[], nullable
  - `is_brand_kit_available` boolean, nullable
  - `is_campaign_proof_available` boolean, nullable
  - `is_email_sendable` boolean, nullable
  - `roster_gap` 'missing_general' | 'missing_pricing' | 'missing_campaign', nullable
  - `is_analysis_available` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-17** `73ef8f3c7792`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/remy/preview/roster/search/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)