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

# Username Proofs API

> gRPC API for retrieving proofs of username ownership on Farcaster

Used to retrieve proofs of username ownership.

## API

| Method Name            | Request Type                                  | Response Type                                     | Description                         |
| ---------------------- | --------------------------------------------- | ------------------------------------------------- | ----------------------------------- |
| GetUsernameProof       | [UsernameProofRequest](#UsernameProofRequest) | [UserNameProof](#UserNameProof)                   | Gets username proof by name         |
| GetUserNameProofsByFid | [FidRequest](#FidRequest)                     | [UsernameProofsResponse](#UsernameProofsResponse) | Gets all username proofs for an FID |

## UsernameProofRequest

| Field | Type  | Label | Description               |
| ----- | ----- | ----- | ------------------------- |
| name  | bytes |       | Username to get proof for |

## UsernameProofsResponse

| Field  | Type          | Label    | Description              |
| ------ | ------------- | -------- | ------------------------ |
| proofs | UserNameProof | repeated | Array of username proofs |

## UserNameProof

| Field     | Type         | Label | Description                            |
| --------- | ------------ | ----- | -------------------------------------- |
| timestamp | uint64       |       | Timestamp of the proof                 |
| name      | bytes        |       | Username being proved                  |
| owner     | bytes        |       | Owner address                          |
| signature | bytes        |       | Cryptographic signature                |
| fid       | uint64       |       | Farcaster ID associated with the proof |
| type      | UserNameType |       | Type of username proof                 |