> For the complete documentation index, see [llms.txt](https://mastodon.gitbook.io/mastodon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mastodon.gitbook.io/mastodon/methods/proofs.md).

# proofs

## View identity proof

<mark style="color:blue;">`GET`</mark> `https://mastodon.example/api/proofs`

**Returns:** custom response defined by provider\
**OAuth:** Public\
**Version history:**\
2.8.0 - added

#### Query Parameters

| Name     | Type   | Description                                                                               |
| -------- | ------ | ----------------------------------------------------------------------------------------- |
| provider | string | The identity provider to be looked up. Currently only supports `keybase` (case-sensitive) |
| username | string | The username on the selected identity provider                                            |

{% tabs %}
{% tab title="200 gargron on keybase" %}

```javascript
{
  "avatar": "https://files.mastodon.social/accounts/avatars/000/000/001/original/d96d39a0abb45b92.jpg",
  "signatures": [
    {
      "sig_hash": "5cfc20c7018f2beefb42a68836da59a792e55daa4d118498c9b1898de7e845690f",
      "kb_username": "gargron"
    }
  ]
}
```

{% endtab %}

{% tab title="404 No identity proof found for username on provider" %}

```javascript
{
  "error": "Record not found"
}
```

{% endtab %}
{% endtabs %}
