# Rewards API

{% hint style="warning" %}
In Q1 2025, the Chiliz team will decommission several endpoints and features. This is to ensure that the Socios.com API remains focused on the Socios.com app features, and to bring it always closer to the Web3 ecosystem. 

Don't worry! We will provide you with alternatives right here on this documentation site.

You will find more information [in this guide](https://connect.socios.com/partner-api/2025-api-update-overview), and in each API section of this site.
{% endhint %}

{% hint style="success" %}
Note: The Rewards API is not changed in the 2025 API Update.
{% endhint %}

## Socios.com Rewards API

The Rewards API aims to provide all information related to the rewards that clubs provide to their most engaged fans.

## Using the Rewards API

{% hint style="info" %}
If you're a new user and do not have access to the Socios.com portal yet, see [prerequisites](https://connect.socios.com/partner-api/prerequisites "mention").
{% endhint %}

1. Once you've logged in to the Socios.com API portal, select **Rewards**.
2. Click the **Try Out** button next to the API URL.
3. You'll see the following modal, indicating the registration steps that are completed. \
   Click the **Try Out** button.\
   ![](https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2Fj7bKjj3regE9xlO92lQZ%2Fimage.png?alt=media\&token=c2bb9bc0-c982-4e55-b491-5429875b2e6a)
4. On the **Security** page that is now displayed, *OAuth* is already selected. Click on the **Get Test Key** button. 
5. Once the test key is generated, you can display it using the <img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FbOs5V6HzE1FDsxyfYUCh%2Fimage.png?alt=media&#x26;token=a58c5a36-10b0-499b-ad64-11eda7c15914" alt="" data-size="line"> icon.&#x20;

## Subscription

1. On the **Subscriptions** page, click on the **SUBSCRIPTION & KEY GENERATION WIZARD** button.
2. Then, enter valid details in the **Create application** form fields:<br>

   <table><thead><tr><th width="374">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>Application Name</td><td>A valid name of the application.</td></tr><tr><td>Shared Quota for Application Tokens</td><td>The amount of tokens generated for each application.</td></tr><tr><td>Application Description </td><td>Optional. A brief description about the application.</td></tr></tbody></table>
3. In the *Subscribe to new application* step, enter the **Application** name you want to use. \
   Select a *Business Plan* from the dropdown menu, and click **Next.**
4. On the *Generate Keys* tab, once you've carefully reviewed the page, select **NEXT**.
5. On the *Generate Access Token* tab, enter a valid description in the **Scopes** field. Select **NEXT**.
6. On the *Copy Access Token* tab, select ![](https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FkQq2AwEL1rl07fIDExOF%2Fimage.png?alt=media\&token=773d6678-8f8a-4877-9c4b-90f6c426ffb5) to copy the Access Token. Once copied, click **FINISH.**
7. You can view your newly created subscription under the **Subscriptions** section.