---
title: "Get creator roster"
method: GET
path: "/evm/rh/creator-roster"
tags: ["Robinhood Chain"]
---

# Get creator roster

`GET /evm/rh/creator-roster`

## Request

- Base URL: `https://public-api-v2.bags.fm/api/v1`
- URL: `https://public-api-v2.bags.fm/api/v1/evm/rh/creator-roster`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/bags/apis/bags-public-api-v2/docs/evm/rh/creator-roster/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the full fee-share roster for a Bags V2 token on Robinhood Chain — every recipient with claimed, claimable, and estimated pending amounts. Combines the fee-share claimer list, live claimable per recipient, the partner and rate from the hook snapshot, per-recipient claim sums from the subgraph, and the estimated pending split. Returns `404` for non-V2 tokens.

## Query parameters

- `tokenAddress` string, required

## Response `200`

Successfully retrieved creator roster

- object
  - `success` boolean, required
  - `response` object
    - `token` string, required: EIP-55 checksummed token address.
    - `feeShare` string, required: Address of the token's fee-share contract.
    - `partner` string, nullable, required: EIP-55 checksummed partner address. Null when the token was launched without a partner.
    - `partnerFeeBps` number, required: Partner's share of the creator-side fee half in basis points, snapshotted at launch.
    - `recipients` RhCreatorRosterRecipient[], required: Every fee-share recipient with claimed, claimable, and estimated pending amounts.
      - `address` string, required: EIP-55 checksummed recipient address.
      - `bps` number, required: Share in basis points: of the claimer pot for claimers, of the creator half for the partner.
      - `isPartner` boolean, required: Whether this recipient is the token's partner.
      - `claimedWei` string, required: Total already claimed by this recipient on this fee share (wei), as string to support bigint.
      - `claimableWei` string, required: Live claimable amount for this recipient (wei), as string to support bigint.
      - `pendingWei` string, required: This recipient's estimated share of the un-swept pending hook fees (wei), as string to support bigint.

## Other responses

- `400`: Bad request - Invalid token address
- `401`: Unauthorized - Invalid or missing API key
- `404`: Not found - The address is not a Bags V2 token
- `500`: Internal server error

---

[API](https://skmtc.dev/bags/apis/bags-public-api-v2.md) - [All operations](https://skmtc.dev/bags/apis/bags-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/bags/apis/bags-public-api-v2/revisions/4a14b82cd39d?raw)