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

# Verifications API

> gRPC API for retrieving address ownership proofs on Farcaster

Used to retrieve valid or revoked proof of ownership of an Ethereum Address.

## API

| Method Name                     | Request Type        | Response Type    | Description                                                  |
| ------------------------------- | ------------------- | ---------------- | ------------------------------------------------------------ |
| GetVerification                 | VerificationRequest | Message          | Returns a VerificationAdd for an Ethereum Address            |
| GetVerificationsByFid           | FidRequest          | MessagesResponse | Returns all VerificationAdds made by an Fid                  |
| GetAllVerificationMessagesByFid | FidTimestampRequest | MessagesResponse | Returns all Verifications made by an Fid with time filtering |

## Verification Request

| Field   | Type   | Label | Description                                             |
| ------- | ------ | ----- | ------------------------------------------------------- |
| fid     | uint64 |       | Farcaster ID of the user who generated the Verification |
| address | bytes  |       | Ethereum Address being verified                         |

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