Skip to main content
GET
/
v2
/
farcaster
/
storage
/
usage
Usage of user
curl --request GET \
  --url https://api.neynar.com/v2/farcaster/storage/usage/ \
  --header 'x-api-key: <api-key>'
{
  "object": "storage_usage",
  "user": {
    "object": "user_dehydrated",
    "fid": 3,
    "username": "<string>",
    "display_name": "<string>",
    "pfp_url": "<string>",
    "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
    "score": 123
  },
  "casts": {
    "object": "storage",
    "used": 3659,
    "capacity": 10000
  },
  "reactions": {
    "object": "storage",
    "used": 3659,
    "capacity": 10000
  },
  "links": {
    "object": "storage",
    "used": 3659,
    "capacity": 10000
  },
  "verified_addresses": {
    "object": "storage",
    "used": 3659,
    "capacity": 10000
  },
  "username_proofs": {
    "object": "storage",
    "used": 3659,
    "capacity": 10000
  },
  "signers": {
    "object": "storage",
    "used": 3659,
    "capacity": 10000
  },
  "total_active_units": 2
}

​
Node.js SDK

🔗 SDK Method: lookupUserStorageUsage Use this API endpoint with the Neynar Node.js SDK for typed responses and better developer experience.

Authorizations

​
x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Query Parameters

​
fid
integer<int32>
required

The unique identifier of a farcaster user or app (unsigned integer)

Required range: x >= 0
Example:

3

Response

Success

​
object
string
Example:

"storage_usage"

​
user
UserDehydrated · object
​
casts
StorageObject · object
​
reactions
StorageObject · object
​
links
StorageObject · object
​
verified_addresses
StorageObject · object
​
username_proofs
StorageObject · object
​
signers
StorageObject · object
​
total_active_units
integer
Example:

2