By FID and Hash

get https://hub-api.neynar.com/v1/castById

Lookup a cast by its FID and hash.

Responses

Response body

object

hash

string

required

hashScheme

string

required

Defaults to HASH_SCHEME_BLAKE3

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

HASH_SCHEME_BLAKE3

signature

string

required

signatureScheme

string

required

Defaults to SIGNATURE_SCHEME_ED25519

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

SIGNATURE_SCHEME_ED25519 SIGNATURE_SCHEME_EIP712

signer

string

required

data

object

required

Common properties shared by all Farcaster message types. These properties provide essential metadata about the message's origin, timing, and network context.

fid

uint64

required

The unique identifier (FID) of the user who created this message. FIDs are assigned sequentially when users register on the network and cannot be changed.

timestamp

int64

required

Seconds since Farcaster Epoch (2021-01-01T00:00:00Z). Used to order messages chronologically and determine the most recent state. Must be within 10 minutes of the current time when the message is created.

network

string

required

Defaults to FARCASTER_NETWORK_MAINNET

Farcaster network the message is intended for.

FARCASTER_NETWORK_MAINNET: Public primary network
FARCASTER_NETWORK_TESTNET: Public test network
FARCASTER_NETWORK_DEVNET: Private test network

FARCASTER_NETWORK_MAINNET FARCASTER_NETWORK_TESTNET FARCASTER_NETWORK_DEVNET

castAddBody

object

required

The content and metadata of the new cast, including the text, mentions, embeds, and any parent references for replies.

type

string

required

Defaults to MESSAGE_TYPE_CAST_ADD

Type of the MessageBody.

MESSAGE_TYPE_CAST_ADD: Add a new Cast
MESSAGE_TYPE_CAST_REMOVE: Remove an existing Cast
MESSAGE_TYPE_REACTION_ADD: Add a Reaction to a Cast
MESSAGE_TYPE_REACTION_REMOVE: Remove a Reaction from a Cast
MESSAGE_TYPE_LINK_ADD: Add a new Link
MESSAGE_TYPE_LINK_REMOVE: Remove an existing Link
MESSAGE_TYPE_VERIFICATION_ADD_ETH_ADDRESS: Add a Verification of an Ethereum Address
MESSAGE_TYPE_VERIFICATION_REMOVE: Remove a Verification
MESSAGE_TYPE_USER_DATA_ADD: Add metadata about a user
MESSAGE_TYPE_USERNAME_PROOF: Add or replace a username proof
MESSAGE_TYPE_FRAME_ACTION: A Farcaster Frame action

MESSAGE_TYPE_CAST_ADD MESSAGE_TYPE_CAST_REMOVE MESSAGE_TYPE_REACTION_ADD MESSAGE_TYPE_REACTION_REMOVE MESSAGE_TYPE_LINK_ADD MESSAGE_TYPE_LINK_REMOVE MESSAGE_TYPE_VERIFICATION_ADD_ETH_ADDRESS MESSAGE_TYPE_VERIFICATION_REMOVE MESSAGE_TYPE_USER_DATA_ADD MESSAGE_TYPE_USERNAME_PROOF MESSAGE_TYPE_FRAME_ACTION

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url https://hub-api.neynar.com/v1/castById \
3
     --header 'accept: application/json' \
4
     --header 'x-api-key: NEYNAR_API_DOCS'


xxxxxxxxxx
41
}
1
{
2
  "hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
3
  "hashScheme": "HASH_SCHEME_BLAKE3",
4
  "signature": "string",
5
  "signatureScheme": "SIGNATURE_SCHEME_ED25519",
6
  "signer": "string",
7
  "data": {
8
    "fid": 2,
9
    "timestamp": 48994466,
10
    "network": "FARCASTER_NETWORK_MAINNET",
11
    "castAddBody": {
12
      "embedsDeprecated": [
13
        "string"
14
      ],
15
      "mentions": [
16
        0
17
      ],
18
      "parentCastId": {
19
        "fid": 2,
20
        "hash": "0x03aff391a6eb1772b20b4ead9a89f732be75fe27"
21
      },
22
      "parentUrl": "chain://eip155:1/erc721:0x39d89b649ffa044383333d297e325d42d31329b2",
23
      "text": "string",
24
      "mentionsPositions": [
25
        0
26
      ],
27
      "embeds": [
28
        {
29
          "castId": {

200The requested Cast.

defaultAn unexpected error response.