GET
/
v1
/
userDataByFid
curl --request GET \
  --url https://hub.pinata.cloud/v1/userDataByFid
{
  "hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
  "hashScheme": "HASH_SCHEME_BLAKE3",
  "signature": "aSDinaTvuI8gbWludGxpZnk=",
  "signatureScheme": "SIGNATURE_SCHEME_ED25519",
  "signer": "<string>",
  "data": {
    "type": "MESSAGE_TYPE_CAST_ADD",
    "fid": 2,
    "timestamp": 48994466,
    "network": "FARCASTER_NETWORK_MAINNET",
    "userDataBody": {
      "type": "USER_DATA_TYPE_PFP",
      "value": "<string>"
    }
  }
}

Query Parameters

fid
integer
required

The FID that's being requested

user_data_type
enum<string>
default: USER_DATA_TYPE_PFP

The type of user data, either as a numerical value or type string. If this is omitted, all user data for the FID is returned

Available options:
USER_DATA_TYPE_PFP,
USER_DATA_TYPE_DISPLAY,
USER_DATA_TYPE_BIO,
USER_DATA_TYPE_URL,
USER_DATA_TYPE_USERNAME
pageSize
integer

Maximum number of messages to return in a single response

reverse
boolean

Reverse the sort order, returning latest messages first

pageToken
string

The page token returned by the previous query, to fetch the next page. If this parameter is empty, fetch the first page

Response

200 - application/json
hash
string
required
hashScheme
enum<string>
default: HASH_SCHEME_BLAKE3required

Type of hashing scheme used to produce a digest of MessageData. - HASH_SCHEME_BLAKE3: Default scheme for hashing MessageData

Available options:
HASH_SCHEME_BLAKE3
signature
string
required
signatureScheme
enum<string>
default: SIGNATURE_SCHEME_ED25519required

Type of signature scheme used to sign the Message hash

  • SIGNATURE_SCHEME_ED25519: Ed25519 signature (default)
  • SIGNATURE_SCHEME_EIP712: ECDSA signature using EIP-712 scheme
Available options:
SIGNATURE_SCHEME_ED25519,
SIGNATURE_SCHEME_EIP712
signer
string
required
data
object
required