Farcaster API
User By FID
- API Keys
- Blog
- Community
Farcaster Development Kit
- Getting Started
- GETCast by Hash
- GETCasts
- POSTSend Cast
- DELDelete Cast
- POSTAdd Reaction to Cast
- DELDelete Reaction to Cast
- GETChannels List
- GETChannel By Name
- POSTFollow FID
- DELUnfollow FID
- GETUser By FID
- GETUsers
- Getting Started
- POSTSigners
- POSTRegister Signer with Warpcast
- POSTPoll Warpcast Signer
- GETGet Signers
Info
Casts
Reactions
Links
User Data
Username Proofs
Verifications
FIDs
Storage
Onchain API
Events
Dev Tools
Farcaster API
Farcaster Auth
Hub API Reference
Farcaster API
User By FID
GET
/
users
/
{fid}
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
fid
integer
*
fid
Required
integer
FID for the user you are trying to fetch
Add Example Value
curl --request GET \
--url https://api.pinata.cloud/v3/farcaster/users/{fid} \
--header 'Authorization: Bearer <token>'
{
"data": {
"fid": 4823,
"custody_address": "0x7f9a6992a54dc2f23f1105921715bd61811e5b71",
"recovery_address": "0x00000000fcb080a4d6c39a9354da9eb9bc104cd7",
"following_count": 811,
"follower_count": 11049,
"verifications": [
"0x1612c6dff0eb5811108b709a30d8150495ce9cc5",
"0xcdcdc174901b12e87cc82471a2a2bd6181c89392"
],
"bio": "Writer. Building @pinatacloud. Tinkering with a Farcaster native alternative to GoodReads: https://readcast.xyz \\ https://polluterofminds.com",
"display_name": "Justin Hunter",
"pfp_url": "https://i.seadn.io/gae/lhGgt7yK1JiBVYz_HBxcAmYLRtP03aw5xKX4FgmFT9Ai7kLD5egzlLvb0lkuRNl28shtjr07DC8IHzLUkTqlWUMndUzC9R5_MSxH3g?w=500&auto=format",
"username": "polluterofminds"
}
}
Authorizations
Authorization
string
headerrequiredBearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
fid
integer
requiredFID for the user you are trying to fetch
Response
200 - application/json
The response is of type object
.
curl --request GET \
--url https://api.pinata.cloud/v3/farcaster/users/{fid} \
--header 'Authorization: Bearer <token>'
{
"data": {
"fid": 4823,
"custody_address": "0x7f9a6992a54dc2f23f1105921715bd61811e5b71",
"recovery_address": "0x00000000fcb080a4d6c39a9354da9eb9bc104cd7",
"following_count": 811,
"follower_count": 11049,
"verifications": [
"0x1612c6dff0eb5811108b709a30d8150495ce9cc5",
"0xcdcdc174901b12e87cc82471a2a2bd6181c89392"
],
"bio": "Writer. Building @pinatacloud. Tinkering with a Farcaster native alternative to GoodReads: https://readcast.xyz \\ https://polluterofminds.com",
"display_name": "Justin Hunter",
"pfp_url": "https://i.seadn.io/gae/lhGgt7yK1JiBVYz_HBxcAmYLRtP03aw5xKX4FgmFT9Ai7kLD5egzlLvb0lkuRNl28shtjr07DC8IHzLUkTqlWUMndUzC9R5_MSxH3g?w=500&auto=format",
"username": "polluterofminds"
}
}