> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neynar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Storage API

> gRPC API for retrieving FID storage limits on Farcaster

Get an FID's storage limits.

## API

| Method Name                  | Request Type | Response Type         | Description                                              |
| ---------------------------- | ------------ | --------------------- | -------------------------------------------------------- |
| GetCurrentStorageLimitsByFid | FidRequest   | StorageLimitsResponse | Returns current storage limits for all stores for an Fid |

## StorageLimitsResponse

| Field               | Type               | Label    | Description                   |
| ------------------- | ------------------ | -------- | ----------------------------- |
| limits              | StorageLimit       | repeated | Storage limits per store type |
| units               | uint32             |          | Number of units               |
| unit\_details       | StorageUnitDetails | repeated | Details about storage units   |
| tier\_subscriptions | TierDetails        | repeated | Tier subscription details     |

## StorageLimit

| Field             | Type      | Label | Description                                            |
| ----------------- | --------- | ----- | ------------------------------------------------------ |
| store\_type       | StoreType |       | The specific type being managed by the store           |
| name              | string    |       | Name of the store type                                 |
| limit             | uint64    |       | The limit of the store type, scaled by the user's rent |
| used              | uint64    |       | Current usage of the store type                        |
| earliestTimestamp | uint64    |       | Timestamp of earliest message                          |
| earliestHash      | bytes     |       | Hash of earliest message                               |

## StorageUnitDetails

| Field      | Type            | Label | Description              |
| ---------- | --------------- | ----- | ------------------------ |
| unit\_type | StorageUnitType |       | Type of storage unit     |
| unit\_size | uint32          |       | Size of the storage unit |

## TierDetails

| Field       | Type     | Label | Description          |
| ----------- | -------- | ----- | -------------------- |
| tier\_type  | TierType |       | Type of tier         |
| expires\_at | uint64   |       | Expiration timestamp |