---
title: "Campaign Roster Picker Endpoint"
method: GET
path: "/api/v1/remy/campaigns/roster-picker"
tags: ["remy"]
---

# Campaign Roster Picker Endpoint

`GET /api/v1/remy/campaigns/roster-picker`

## 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/campaigns/roster-picker`
- Auth: HTTP bearer

'Add influencers' checkbox-list source — every DM-pickable creator, paginated; MUST stay above /campaigns/{campaign_id} or it gets shadowed.

## Query parameters

- `search` string[], nullable: Handle or name substrings, case-insensitive; comma-separated or repeated, any one matches.
- `platform` string[], nullable: Narrow to one/more platforms, e.g. ?platform=instagram
- `creator_ids` string[], nullable: Hydrate exactly these creator ids into full rows, e.g. a negotiation-list batch
- `cursor` string, nullable: next_cursor from the previous response; infinite scroll, `page` is then ignored
- `page` integer
- `size` integer

## Response `200`

Successful Response

- RosterPickerPageDTO
  - `items` CreatorDropdownItemDTO[], required
    - `creator_id` string, required
    - `platform` string, required
    - `handle` string, nullable
    - `display_name` string, nullable
    - `followers` integer, nullable
    - `profile_pic_url` string, nullable
    - `added_at` string, date-time, nullable
    - `has_email` boolean
  - `total` integer, nullable
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-13** `c7202552278d`: 4 breaking, 3 info
  - `query` request parameter `search` list-of-types was narrowed by removing types `string`
  - for the `query` request parameter `search`, the type of property `anyOf[subschema #1]/` was specialized from `string` to `array`
  - the response property `total` became optional for the status `200`
  - response property `total` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …3 more

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/remy/campaigns/roster-picker/get.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)