> ## 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.

# UserData API

> gRPC API for retrieving user metadata associated with Farcaster accounts

Used to retrieve the current metadata associated with a user

## API

| Method Name | Request Type | Response Type | Description |
| - | - | - | - |
| GetUserData | UserDataRequest | Message | Returns a specific UserData for an Fid |
| GetUserDataByFid | FidRequest | MessagesResponse | Returns all UserData for an Fid |
| GetAllUserDataMessagesByFid | FidTimestampRequest | MessagesResponse | Returns all UserData for an Fid with timestamp filtering |

## UserData Request

| Field | Type | Label | Description |
| - | - | - | - |
| fid | uint64 | | Farcaster ID of the user who generated the UserData |
| user\_data\_type | UserDataType | | Type of UserData being requested |

## Messages Response

| Field | Type | Label | Description |
| - | - | - | - |
| messages | Message | repeated | Farcaster Message array |
| next\_page\_token | bytes | optional | Token for pagination |

## FidTimestampRequest

| Field | Type | Label | Description |
| - | - | - | - |
| fid | uint64 | | Farcaster ID |
| page\_size | uint32 | optional | Number of results to return per page |
| page\_token | bytes | optional | Token for pagination |
| reverse | bool | optional | Whether to return results in reverse order |
| start\_timestamp | uint64 | optional | Optional timestamp to start filtering from |
| stop\_timestamp | uint64 | optional | Optional timestamp to stop filtering at |


## Related topics

- [UserData API](/snapchain/httpapi/userdata.md)
- [Usernames](/farcaster/learn/what-is-farcaster/usernames.md)
- [Fetch UserData for a FID](/reference/fetch-user-data.md)
- [Messages](/snapchain/datatypes/messages.md)
- [Create messages](/farcaster/developers/guides/writing/messages.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.