Retrieve notifications for a given user

farcasterNotification.getNotificationByFid

Overview

Returns a list of notifications for a specific FID.

Parameters

name
type
required
Note

fid

number

true

ex) 721870

type

string

false

"follows", "recasts", "likes", "mentions" or "replies"

cursor

string

false

ex) eyJwYWdlIjoyfQ==

Usage

let res = await Lum0x.farcasterNotification.getNotificationByFid({
    fid: 777777
});
console.log(JSON.stringify(res, null, 2));

Response

{
  "notifications": [
    {
      "object": "notification",
      "most_recent_timestamp": "2024-08-19T11:44:26.000Z",
      "type": "follows",
      "follows": [
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 538923,
            "custody_address": "0xea397ce28ebe2f7968ddfb4386bd295642a2b0b7",
            "username": "promenadefp",
            "display_name": "TechWizard101",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/fc95e20b-c65b-4963-0700-dc852d2c9900/rectcrop3",
            "profile": {
              "bio": {
                "text": "Your daily dose of tech insights, from reviews of the latest gadgets to IT troubleshooting tips."
              }
            },
            "follower_count": 143,
            "following_count": 481,
            "verifications": [],
            "verified_addresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        }
      ],
      "count": 1
    },
    {
      "object": "notification",
      "most_recent_timestamp": "2024-08-08T18:04:13.000Z",
      "type": "follows",
      "follows": [
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 607274,
            "custody_address": "0x413a5e66726e224beb725ab81435d17493dd73bc",
            "username": "xmbnpumpkin",
            "display_name": "quantumwhiz  ",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/b75312d8-c86d-4f0f-6178-fd280a3c8900/rectcrop3",
            "profile": {
              "bio": {
                "text": "Passionate about cryptographic innovations and digital currencies. Sharing insights on blockchain technology and the future of decentralized finance."
              }
            },
            "follower_count": 57,
            "following_count": 486,
            "verifications": [],
            "verified_addresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        }
      ],
      "count": 1
    },
    {
      "object": "notification",
      "most_recent_timestamp": "2024-08-04T07:31:10.000Z",
      "type": "follows",
      "follows": [
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 344577,
            "custody_address": "0x2a74c4843236c0c329157fa316c1373fb9fcb161",
            "username": "tadashi00",
            "display_name": "Tadashi",
            "pfp_url": "https://i.imgur.com/bc1e5RQ.jpg",
            "profile": {
              "bio": {
                "text": "I am Abhijith vs \n-currently work in aptos ecosystem\n-3+ years experience in crypto\n-Community manager @swapGPT"
              }
            },
            "follower_count": 43,
            "following_count": 57,
            "verifications": [
              "0xfa5d5d5aac485b617a9de0d4ad24fc2f0cc2f350",
              "0xfa5d5d5aac485b617a9de0d4ad24fc2f0cc2f350"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0xfa5d5d5aac485b617a9de0d4ad24fc2f0cc2f350",
                "0xfa5d5d5aac485b617a9de0d4ad24fc2f0cc2f350"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        }
      ],
      "count": 1
    },
    {
      "object": "notification",
      "most_recent_timestamp": "2024-07-17T09:12:53.000Z",
      "type": "follows",
      "follows": [
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 252943,
            "custody_address": "0xd82299634461063db4f3c26533ff265ca7de1a8f",
            "username": "boldrin7",
            "display_name": "Boldrin",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/ef5b12af-e86d-4c95-74ee-83608eb12400/original",
            "profile": {
              "bio": {
                "text": "Digitally Mentally Artistic!!"
              }
            },
            "follower_count": 137,
            "following_count": 377,
            "verifications": [
              "0x41550ec61cc1d607b776379aea1d4b9d18b1bade",
              "0x8034857f8a467624baf973de28026ceb9a2ff5f1"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0x41550ec61cc1d607b776379aea1d4b9d18b1bade",
                "0x8034857f8a467624baf973de28026ceb9a2ff5f1"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        }
      ],
      "count": 1
    },
    {
      "object": "notification",
      "most_recent_timestamp": "2024-07-11T21:05:50.000Z",
      "type": "follows",
      "follows": [
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 777927,
            "custody_address": "0x20f0ab8ef51cef576378e069f61ef7a0b12dc0e1",
            "username": "james123",
            "display_name": "James Crypto",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/8e6f127f-4708-4e64-d1f8-0fa0475dd300/rectcrop3",
            "profile": {
              "bio": {
                "text": "NFT🌓"
              }
            },
            "follower_count": 478,
            "following_count": 2495,
            "verifications": [],
            "verified_addresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 704194,
            "custody_address": "0x737dba003badcf8a84a208e7843cb18194c0fb22",
            "username": "freedagreen966",
            "display_name": "FreedaGreen966168",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/6da4b875-d679-4c0c-7593-e76f3497ad00/rectcrop3",
            "profile": {
              "bio": {
                "text": ""
              }
            },
            "follower_count": 219,
            "following_count": 388,
            "verifications": [
              "0x2cc454ab40c7b97a0be57417e90436a0f8a05d4c"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0x2cc454ab40c7b97a0be57417e90436a0f8a05d4c"
              ],
              "sol_addresses": [
                "BFoadWNCNzKP9LE2LXVFLfe9sKi78WxDCVxfcbEPCprh"
              ]
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 690333,
            "custody_address": "0x5d65c8eea6b57c25c34a45bbc42db236586fc032",
            "username": "benjiman",
            "display_name": "Benjamin\n",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/dcb7de09-29f4-44af-3e24-84a58cf49000/rectcrop3",
            "profile": {
              "bio": {
                "text": "Tech guru and sports fanatic."
              }
            },
            "follower_count": 27,
            "following_count": 170,
            "verifications": [
              "0xd026e93c15e06a7e2dbeb6d3d5001f0f8d223e74"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0xd026e93c15e06a7e2dbeb6d3d5001f0f8d223e74"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 640887,
            "custody_address": "0x920884ee03d68de18e46f44650c7a04ea1891385",
            "username": "vebich",
            "display_name": "Vladyslava",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/68a63ee4-d35f-4196-f945-b19f39d9a100/rectcrop3",
            "profile": {
              "bio": {
                "text": "Creator of designer clothes and in love with crypto"
              }
            },
            "follower_count": 47,
            "following_count": 237,
            "verifications": [],
            "verified_addresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 268095,
            "custody_address": "0x00dbd4f017cc05e777a3f8811bd6aa9e1a5e3891",
            "username": "vikasch",
            "display_name": "Vishnu KK",
            "pfp_url": "https://i.imgur.com/8beckY7.jpg",
            "profile": {
              "bio": {
                "text": "Hope"
              }
            },
            "follower_count": 67,
            "following_count": 103,
            "verifications": [
              "0xdb0669f9eb81456ea121dbf732c85c2848fb1920"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0xdb0669f9eb81456ea121dbf732c85c2848fb1920"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 772392,
            "custody_address": "0xb6969f4d96377fa036786eed1ed8944f5a45bb2b",
            "username": "masonn",
            "display_name": "Mason ",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/9629d156-eb35-437b-3470-7365b8171e00/rectcrop3",
            "profile": {
              "bio": {
                "text": "🌑 Crypto Trader | Blockchain Advocate | NFT Collector 🌉"
              }
            },
            "follower_count": 666,
            "following_count": 2500,
            "verifications": [],
            "verified_addresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 763796,
            "custody_address": "0x1a4cb608218967e19796ec93534729f8e52dffed",
            "username": "ladydiana",
            "display_name": "Lady Diana ",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/28fa4e57-02cb-4ce5-5ac0-ef7785e75b00/rectcrop3",
            "profile": {
              "bio": {
                "text": ""
              }
            },
            "follower_count": 38,
            "following_count": 133,
            "verifications": [
              "0x905f2c9d2c93ab06bc1216de43031d9321f92cfc"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0x905f2c9d2c93ab06bc1216de43031d9321f92cfc"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 632140,
            "custody_address": "0x46bcac6147a6e0b1275b9c512a210558d8de8112",
            "username": "natali1",
            "display_name": "Natali",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/48fd289e-ea39-4ab8-acc8-345b612c0700/rectcrop3",
            "profile": {
              "bio": {
                "text": "I love traveling, fitness and just being a good mom 👩❤️❤️❤️"
              }
            },
            "follower_count": 1095,
            "following_count": 2501,
            "verifications": [
              "0x7a6cb276c5e38b20e6e478efe77ec669835b8623",
              "0x7a6cb276c5e38b20e6e478efe77ec669835b8623",
              "0x7a6cb276c5e38b20e6e478efe77ec669835b8623"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0x7a6cb276c5e38b20e6e478efe77ec669835b8623",
                "0x7a6cb276c5e38b20e6e478efe77ec669835b8623",
                "0x7a6cb276c5e38b20e6e478efe77ec669835b8623"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 397627,
            "custody_address": "0x4db0f79355835d2940478d802fa2e64281c6f19c",
            "username": "elcryptofounder",
            "display_name": "Eldar",
            "pfp_url": "https://i.imgur.com/ualde9s.jpg",
            "profile": {
              "bio": {
                "text": "I am interested in crypto. I reserch blockchain."
              }
            },
            "follower_count": 289,
            "following_count": 629,
            "verifications": [
              "0x2f30998c61b21179aa237f77fd578ba8679eb43d",
              "0x2f30998c61b21179aa237f77fd578ba8679eb43d"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0x2f30998c61b21179aa237f77fd578ba8679eb43d",
                "0x2f30998c61b21179aa237f77fd578ba8679eb43d"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 758770,
            "custody_address": "0x2c3dbe538316ab7572870df8dd60d9bac647b15b",
            "username": "dudleson",
            "display_name": "Leson Saturn",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/4ee5bd4f-00f7-48ce-2469-af8f25f46200/rectcrop3",
            "profile": {
              "bio": {
                "text": ":)"
              }
            },
            "follower_count": 51,
            "following_count": 185,
            "verifications": [
              "0xcf901fbcc19caf85823849415383eab3ee189de1"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0xcf901fbcc19caf85823849415383eab3ee189de1"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 757804,
            "custody_address": "0x27706f5f342a01717f70816062271a903fdb4053",
            "username": "simonaasti",
            "display_name": "Simona",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/80e4c285-7514-4434-4fc7-b2aa71bf9f00/rectcrop3",
            "profile": {
              "bio": {
                "text": "Hi im new here trying teach something"
              }
            },
            "follower_count": 84,
            "following_count": 248,
            "verifications": [
              "0x963facbd9c2d40a15c4cb9076e50b873a60ba9ce"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0x963facbd9c2d40a15c4cb9076e50b873a60ba9ce"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        },
        {
          "object": "follow",
          "user": {
            "object": "user",
            "fid": 762890,
            "custody_address": "0xf0212b2910a740b6279f7c0d60e62b0272b1f2a1",
            "username": "juliya221",
            "display_name": "Julia J.",
            "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/7e88ec00-4379-4a2f-c88f-e7371b906100/rectcrop3",
            "profile": {
              "bio": {
                "text": ""
              }
            },
            "follower_count": 58,
            "following_count": 189,
            "verifications": [
              "0x92b9bcfa7913d063764c56db49f0c8091d3e0a81"
            ],
            "verified_addresses": {
              "eth_addresses": [
                "0x92b9bcfa7913d063764c56db49f0c8091d3e0a81"
              ],
              "sol_addresses": []
            },
            "active_status": "inactive",
            "power_badge": false,
            "viewer_context": {
              "following": false,
              "followed_by": true
            }
          }
        }
      ],
      "count": 12
    },
    {
      "object": "notification",
      "most_recent_timestamp": "2024-07-11T21:02:04.000Z",
      "type": "reply",
      "cast": {
        "object": "cast",
        "hash": "0xd5ebd1da7a53b66d4e1522121053c60639464d1f",
        "thread_hash": "0x984b3716cfc67775912b1a01507a77eedef39eaf",
        "parent_hash": "0x984b3716cfc67775912b1a01507a77eedef39eaf",
        "parent_url": null,
        "root_parent_url": null,
        "parent_author": {
          "fid": 777777
        },
        "author": {
          "object": "user",
          "fid": 651962,
          "custody_address": "0x718c6786bdf2f428839598fca41854a99c1860c3",
          "username": "inanis",
          "display_name": "Mikhail",
          "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/03de5874-4405-4ead-9bd7-b8ea89c83d00/rectcrop3",
          "profile": {
            "bio": {
              "text": ""
            }
          },
          "follower_count": 64,
          "following_count": 214,
          "verifications": [
            "0x38ab2ea7da2dda252daa4429dbdb2e06e6c8dfd8"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0x38ab2ea7da2dda252daa4429dbdb2e06e6c8dfd8"
            ],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": false,
          "viewer_context": {
            "following": false,
            "followed_by": false
          }
        },
        "text": "Vamos a empezar. Es importante tener un buen inicio para lograr nuestros objetivos. ¡Adelante!",
        "timestamp": "2024-07-11T21:02:04.000Z",
        "embeds": [],
        "reactions": {
          "likes_count": 0,
          "recasts_count": 0,
          "likes": [],
          "recasts": []
        },
        "replies": {
          "count": 0
        },
        "channel": null,
        "mentioned_profiles": [],
        "viewer_context": {
          "liked": false,
          "recasted": false
        }
      }
    }
  ],
  "next": {
    "cursor": null
  }
}
Timestamp
Type
Username
Display Name
Bio
Profile Image URL
Follower Count
Following Count
Verified ETH Addresses

2024-08-19T11:44:26

Follows

promenadefp

TechWizard101

Your daily dose of tech insights, from reviews of the latest gadgets to IT troubleshooting tips.

143

481

None

2024-08-08T18:04:13

Follows

xmbnpumpkin

quantumwhiz

Passionate about cryptographic innovations and digital currencies. Sharing insights on blockchain technology and the future of decentralized finance.

57

486

None

2024-08-04T07:31:10

Follows

tadashi00

Tadashi

I am Abhijith vs \n-currently work in aptos ecosystem\n-3+ years experience in crypto\n-Community manager @swapGPT

43

57

[0xfa5d5d5aac485b617a9de0d4ad24fc2f0cc2f350]

2024-07-17T09:12:53

Follows

boldrin7

Boldrin

Digitally Mentally Artistic!!

137

377

[0x41550ec61cc1d607b776379aea1d4b9d18b1bade, 0x8034857f8a467624baf973de28026ceb9a2ff5f1]

2024-07-11T21:05:50

Follows

james123

James Crypto

NFT🌓

478

2495

None

2024-07-11T21:05:50

Follows

freedagreen966

FreedaGreen966168

219

388

[0x2cc454ab40c7b97a0be57417e90436a0f8a05d4c]

2024-07-11T21:05:50

Follows

benjiman

Benjamin

Tech guru and sports fanatic.

27

170

[0xd026e93c15e06a7e2dbeb6d3d5001f0f8d223e74]

2024-07-11T21:05:50

Follows

vebich

Vladyslava

Creator of designer clothes and in love with crypto

47

237

None

2024-07-11T21:05:50

Follows

vikasch

Vishnu KK

Hope

67

103

[0xdb0669f9eb81456ea121dbf732c85c2848fb1920]

2024-07-11T21:05:50

Follows

masonn

Mason

🌑 Crypto Trader

Blockchain Advocate

NFT Collector 🌉

666

2024-07-11T21:05:50

Follows

ladydiana

Lady Diana

38

133

[0x905f2c9d2c93ab06bc1216de43031d9321f92cfc]

2024-07-11T21:05:50

Follows

natali1

Natali

I love traveling, fitness and just being a good mom 👩❤️❤️❤️

1095

2501

[0x7a6cb276c5e38b20e6e478efe77ec669835b8623, 0x7a6cb276c5e38b20e6e478efe77ec669835b8623, 0x7a6cb276c5e38b20e6e478efe77ec669835b8623]

2024-07-11T21:05:50

Follows

elcryptofounder

Eldar

I am interested in crypto. I reserch blockchain.

289

629

[0x2f30998c61b21179aa237f77fd578ba8679eb43d, 0x2f30998c61b21179aa237f77fd578ba8679eb43d]

2024-07-11T21:05:50

Follows

dudleson

Leson Saturn

:)

51

185

[0xcf901fbcc19caf85823849415383eab3ee189de1]

2024-07-11T21:05:50

Follows

simonaasti

Simona

Hi im new here trying teach something

84

248

[0x963facbd9c2d40a15c4cb9076e50b873a60ba9ce]

2024-07-11T21:05:50

Follows

juliya221

Julia J.

58

189

[0x92b9bcfa7913d063764c56db49f0c

Field Description

  • object: Represents the type of data (e.g., notification or user).

  • most_recent_timestamp: Represents the most recent timestamp.

  • type: Indicates the type of notification (e.g., follows, reply).

  • follows: An array containing information related to user follows.

  • count: Represents the number of notifications of that type.

  • cast: An object containing information about a specific comment or post.

  • hash: The unique hash value of the post.

  • thread_hash: The unique hash value of the comment thread.

  • parent_hash: The hash value of the parent post of the comment.

  • author: Information about the author of the comment or post.

  • text: The content of the comment or post.

  • timestamp: The timestamp of the comment or post.

  • embeds: Embedded content included in the comment or post.

  • reactions: Information about reactions to the comment or post (e.g., likes count, recasts count).

  • replies: The number of replies to the comment.

  • mentioned_profiles: A list of profiles mentioned in the comment or post.

  • viewer_context: Indicates the interaction state between the user and the comment or post (e.g., whether it was liked or recast).

  • verified_addresses: A list of verified addresses (e.g., Ethereum, Solana addresses).

  • active_status: Indicates the user's activity status (e.g., inactive).

  • power_badge: Indicates whether the user holds a special badge.

PreviousFarcasterNotificationNextFarcasterMoxie

Last updated