Skip to main content
GET
/
api
/
public
/
v1
/
projects
/
{slug}
/
buyers
List a project's buyers
curl --request GET \
  --url https://thefirm.biz/api/public/v1/projects/{slug}/buyers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "source": "farcaster",
      "fid": 3324275,
      "username": "nurt",
      "pfpUrl": "https://thefirm.biz/profiles/headshots/headshot-nurt.png",
      "followerCount": 1240
    },
    {
      "source": "x",
      "fid": 0,
      "username": "thefirm",
      "pfpUrl": "https://pbs.twimg.com/profile_images/thefirm.jpg",
      "followerCount": 980
    },
    {
      "source": "wallet",
      "fid": 0,
      "username": "0x1234…5678",
      "pfpUrl": null,
      "followerCount": 0
    }
  ],
  "meta": {
    "limit": 20,
    "nextCursor": null
  }
}

Authorizations

​
Authorization
string
header
required

API key issued via POST /api/public/v1/api-keys.

Path Parameters

​
slug
string
required

URL-safe identifier of the project.

Example:

"yurts-by-nurt"

Query Parameters

​
cursor
string

Opaque cursor marking where the previous page ended. Omit it to fetch the first page; pass the meta.nextCursor from a response verbatim to fetch the next. A null meta.nextCursor means there are no more pages. Treat the value as opaque — its format varies per endpoint.

Minimum string length: 1
​
limit
integer | null
default:20

Maximum number of items per page. Defaults to 20; values are clamped to 1–100.

Response

A page of buyers.

​
data
object[]
required
​
meta
object
required