Skip to main content

GET /api/farcaster/notifications/{fid}

User notifications

GET notifications data from farcaster service

Endpoint​

GET https://api.web3identity.com/api/farcaster/notifications/{fid}

Parameters​

NameInTypeRequiredDescription
fidpathstringâś…Farcaster user ID

Example Request​

curl -s "https://api.web3identity.com/api/farcaster/notifications/:fid" | jq

Responses​

200 Success​

{
  "fid": 3,
  "notifications": [
    {
      "type": "mention",
      "castHash": "0xabc123",
      "from": {
        "fid": 456,
        "username": "alice"
      },
      "timestamp": 1707393600
    },
    {
      "type": "reply",
      "castHash": "0xdef456",
      "from": {
        "fid": 789,
        "username": "bob"
      },
      "timestamp": 1707393500
    },
    {
      "type": "like",
      "castHash": "0xghi789",
      "from": {
        "fid": 1011,
        "username": "charlie"
      },
      "timestamp": 1707393400
    }
  ]
}

400 Bad request - invalid parameters​

{
  "example": "response"
}

402 Payment required​

404 Resource not found​

{
  "example": "response"
}

429 Rate Limited​

{
  "example": "response"
}

500 Internal Server Error - Something went wrong on our end​

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

Auto-generated from OpenAPI spec