# API Reference

## Authorization Requests

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95>" path="/authorize/" method="get" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media\&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95)
{% endopenapi %}

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2FSInEmwUP4t8OaER7Uoxj%2Foauth2.json?alt=media&token=3c874826-1864-4b37-8b35-36aa8bdbc02f>" path="/authorize/" method="post" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2FSInEmwUP4t8OaER7Uoxj%2Foauth2.json?alt=media\&token=3c874826-1864-4b37-8b35-36aa8bdbc02f)
{% endopenapi %}

## Token Requests

{% hint style="info" %}
Content-Type must be `application/x-www-form-urlencoded`
{% endhint %}

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F5wH2numQpSE6WyNDpGWr%2Foauth2.json?alt=media&token=b11a6ad2-e11e-4e1f-831b-75d6e33a497b>" path="/token/" method="post" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F5wH2numQpSE6WyNDpGWr%2Foauth2.json?alt=media\&token=b11a6ad2-e11e-4e1f-831b-75d6e33a497b)
{% endopenapi %}

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95>" path="/token/revoke" method="post" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media\&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95)
{% endopenapi %}

## User data requests (v1, deprecated)

{% hint style="danger" %}
This will be deprecated, please use the V2 User APIs. [Click here](https://docs.matrica.io/matrica-connect/oauth2-api-reference-v2) to access the V2 docs.
{% endhint %}

{% hint style="info" %}
Use the user's OAuth2 access token to make these calls.

In the HTTP request header: `Authorization: Bearer xxxx` where `xxxx` is the access token
{% endhint %}

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95>" path="/user/profile" method="get" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media\&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95)
{% endopenapi %}

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95>" path="/user/wallets" method="get" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media\&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95)
{% endopenapi %}

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95>" path="/user/nfts" method="get" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media\&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95)
{% endopenapi %}

## Get OAuth2 user verified email

<mark style="color:blue;">`GET`</mark> `https://api.matrica.io/oauth2/user/email`

Returns the user data including their verified email. If the user doesn't have a verified email. this will `null`.

{% tabs %}
{% tab title="200: OK User verified email or null" %}

{% endtab %}
{% endtabs %}

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95>" path="/user/discord" method="get" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media\&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95)
{% endopenapi %}

{% openapi src="<https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95>" path="/user/twitter" method="get" %}
[oauth2.json](https://2946875910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLywT3slSQ4GoAk6k17dV%2Fuploads%2F3oWVCt0SN3J0Dlmom8r3%2Foauth2.json?alt=media\&token=58d8e05f-ff32-426d-8a24-f0ce0b2bbb95)
{% endopenapi %}

## Get OAuth2 user telegram.

<mark style="color:blue;">`GET`</mark> `https://api.matrica.io/oauth2/user/telegram`

{% tabs %}
{% tab title="200: OK Returns the OAuth2 user telegram" %}

{% endtab %}
{% endtabs %}