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