GET
/
v1
/
castById
By FID and Hash
curl --request GET \
  --url https://hub-api.neynar.com/v1/castById \
  --header 'x-api-key: <api-key>'
{
  "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",
    "castAddBody": {
      "embedsDeprecated": [
        "<string>"
      ],
      "mentions": [
        2
      ],
      "parentCastId": {
        "fid": "<any>",
        "hash": "<any>"
      },
      "parentUrl": "chain://eip155:1/erc721:0x39d89b649ffa044383333d297e325d42d31329b2",
      "text": "<string>",
      "mentionsPositions": [
        123
      ],
      "embeds": [
        {
          "castId": {
            "fid": "<any>",
            "hash": "<any>"
          }
        }
      ]
    }
  }
}

Authorizations

x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Query Parameters

fid
integer
required

The FID of the cast's creator

Required range: x >= 1
Example:

1

hash
string
required

The unique hash identifier of the cast. This is a 40-character hexadecimal string prefixed with '0x' that uniquely identifies a specific cast in the Farcaster network.

Example:

"0x03aff391a6eb1772b20b4ead9a89f732be75fe27"

Response

The requested Cast.

hash
string
required
Example:

"0xd2b1ddc6c88e865a33cb1a565e0058d757042974"

hashScheme
enum<string>
default:HASH_SCHEME_BLAKE3
required

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<byte>
required
signatureScheme
enum<string>
default:SIGNATURE_SCHEME_ED25519
required

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

Represents a new cast (post) being created in the Farcaster network. A cast can include text content, mentions of other users, embedded URLs, and references to parent posts for replies. Common properties shared by all Farcaster message types. These properties provide essential metadata about the message's origin, timing, and network context.