# API Reference

## Authorization Requests

{% openapi src="/files/uJZNPtJ6QZbWy0fOOZxY" 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="/files/3NaJK0aQKW8t81uEcwIP" 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="/files/O6BQVUrsgGv3QL26ClbP" 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="/files/uJZNPtJ6QZbWy0fOOZxY" 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](/matrica-connect/oauth2-api-reference-v2.md) 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="/files/uJZNPtJ6QZbWy0fOOZxY" 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="/files/uJZNPtJ6QZbWy0fOOZxY" 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="/files/uJZNPtJ6QZbWy0fOOZxY" 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="/files/uJZNPtJ6QZbWy0fOOZxY" 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="/files/uJZNPtJ6QZbWy0fOOZxY" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.matrica.io/matrica-connect/api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.