# Roster

> The hosts you actively work with, with their public profile, commission rate and how many of your campaigns each one has joined.

- Audience: API
- Page type: reference
- Updated: 2026-10-08
- Canonical URL: https://www.rendezvu.co/docs/api/roster

Your roster is the hosts with an active relationship with your brand, the My Hosts list in your console. Each entry carries the host's public profile and your terms with them. Invited hosts who have not joined, and hosts you found in Discover, are not on it.

Host email, phone and address are never part of a roster entry, and neither are the private tags and notes your team keeps on a host.

## List roster hosts

`GET /api/brand/v1/roster`

The hosts you actively work with, with their public profile, commission rate and campaign counts. Your team’s private host tags and notes stay in the console.

Scope: `roster:read`. Paginated.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `page` | integer, optional, default `1` | The page to return, starting at 1. At most 10,000. |
| `per_page` | integer, optional, default `25` | Items per page, between 1 and 100. |

**Returns**

A page of roster relationships. `data` is an array of objects with these attributes, and the body carries `pagination`.

| Attribute | Type | Description |
| --- | --- | --- |
| `relationship_id` | string | The id of your relationship with the host. |
| `host` | object | The host’s public profile. |
| `host.id` | string | The host’s Rendezvu user id (UUID). |
| `host.username` | string, nullable | The host’s handle, as in rendezvu.co/username. |
| `host.first_name` | string, nullable | First name. |
| `host.last_name` | string, nullable | Last name. |
| `host.profile_photo` | string, nullable | URL of the host’s profile photo. |
| `host.title` | string, nullable | The host’s headline, such as "Ultrarunner and coach". |
| `host.intro` | string, nullable | The host’s public bio. |
| `host.discipline` | string, nullable | Primary discipline, such as trail running. |
| `host.specialty` | string, nullable | Specialty within the discipline. |
| `host.location` | string, nullable | City-level location. Never an address. |
| `host.socials` | object, nullable | Public social links, keyed by network: instagram, tiktok, youtube, strava, website, twitter, facebook, linkedin. Only http(s) URLs the host made public; null when there are none. |
| `status` | string | The relationship status. Always active here. |
| `commission_rate` | number | This host’s commission rate with you, as a percentage. Your default rate when no custom rate is set. |
| `joined_at` | timestamp | When the relationship was created. |
| `activated_at` | timestamp, nullable | When it became active. |
| `campaigns` | object, nullable | The host’s campaigns with you, by state. |
| `campaigns.status` | enum | One state per host, highest wins: `active`, `invited`, `completed` or `none`. |
| `campaigns.invited` | integer | Campaigns they were invited to. |
| `campaigns.active` | integer | Campaigns in progress. |
| `campaigns.completed` | integer | Campaigns completed. |
| `campaigns.declined` | integer | Campaigns declined. |

**Example request**

```bash
curl 'https://api.rendezvu.co/api/brand/v1/roster?per_page=1' \
  -H "Authorization: Bearer $RENDEZVU_BRAND_API_KEY"
```

**Example response**

```json
{
  "success": true,
  "data": [
    {
      "relationship_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "host": {
        "id": "6f1c2a9e-3b4d-4e1f-9a8b-2c7d5e6f7a81",
        "username": "jordanalpine",
        "first_name": "Jordan",
        "last_name": "Reyes",
        "profile_photo": "https://media.rendezvu.co/6f1c2a9e_profile.jpg",
        "title": "Ultrarunner and coach",
        "intro": "Mountain miles in the Sierra, every season.",
        "discipline": "Trail running",
        "specialty": "Ultramarathon",
        "location": "Truckee, CA",
        "socials": {
          "instagram": "https://instagram.com/jordanalpine",
          "strava": "https://www.strava.com/athletes/000000"
        }
      },
      "status": "active",
      "commission_rate": 12,
      "joined_at": "2026-04-02T16:30:00.000Z",
      "activated_at": "2026-04-03T09:12:00.000Z",
      "campaigns": {
        "status": "active",
        "invited": 1,
        "active": 1,
        "completed": 3,
        "declined": 0
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total_items": 37,
    "total_pages": 37,
    "has_next": true,
    "has_prev": false
  },
  "_timing": {
    "duration_ms": 42
  }
}
```

## Related

- [Analytics](https://www.rendezvu.co/docs/api/analytics.md): Clicks, views, buy-now clicks and attributed sales for your products, as a summary, a time series and per host. Human traffic only.
- [Recommendations](https://www.rendezvu.co/docs/api/recommendations.md): Hosts recommending your products on their public gear lists, with their notes and a host-attributed link per product. Built to render on your site.

---

Source: https://www.rendezvu.co/docs/api/roster (Rendezvu docs, Markdown view). Every page: https://www.rendezvu.co/llms.txt