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

# Get creator roster

`GET /evm/rh/creator-roster`

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.net/bags/apis/bags-public-api-v2.md) · [All operations](https://skmtc.net/bags/apis/bags-public-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bags/bags-public-api-v2/revisions/4a14b82cd39d/schema)