# Data 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.&#x20;

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 Data API is not changed in the 2025 API Update.
{% endhint %}

## Socios.com Data API

The Data API aims to provide optional information you may need for filtering, naming, translating, categorising, and so on. With the help of Data API, you will be able to retrieve all leagues, sports, and countries handled in the Socios.com environment.&#x20;

In addition, you can retrieve the list of all the available leagues handled by Socios.com and their respective IDs. You can further use it to filter out other endpoints as well.&#x20;

## Using the Data API&#x20;

{% 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 **Data**.

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FXQyvQ36e5zrKET7XSeOh%2FScreenshot%202023-02-21%20at%2010.55.21%20AM.png?alt=media&#x26;token=9166a2aa-2b89-47b6-903e-44595b861593" alt=""><figcaption></figcaption></figure>

2. Click the **Try Out** button next to the API URL.

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FXHEPEPFMaTmvgGntW9pz%2Fimage.png?alt=media&#x26;token=83bc52be-ddae-4f7a-822d-fd95ce67bf0a" alt=""><figcaption></figcaption></figure>

3. You'll see the following modal, indicating registering steps completed. \
   Click the **Try Out** button.

![](https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2F0pmTSM4JBY1mSRGWc1FW%2Fimage.png?alt=media\&token=1cf52005-0eaa-4714-a312-de27c890320b)

4. On the **Security** page that is now displayed, *OAuth* is already selected. Click on the **Get Test Key** button.&#x20;

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FFORSQLCv6c6pRQ74oZ1m%2Fimage.png?alt=media&#x26;token=923c8449-52d8-48a5-b343-3b0397d5bc7d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can either use the existing Access token or generate a new Test Key.
{% endhint %}

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;

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FihsHEEKN8mq1lOnooZgk%2Fimage.png?alt=media&#x26;token=66e2221f-ea71-46e8-bf18-9b6189c9acfc" alt=""><figcaption></figcaption></figure>

## Subscription

1. On the **Subscriptions** page then click on the **SUBSCRIPTION & KEY GENERATION WIZARD** button.

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2Fx8qdJjHwvuQByrzaPxIx%2Fimage.png?alt=media&#x26;token=dc561f64-7949-4951-afb4-c27eef7ca90c" alt=""><figcaption></figcaption></figure>

2. Then, enter valid details in the **Create application** form fields:

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2F1cgpMQTwRRy0wKuzYEYb%2Fimage.png?alt=media&#x26;token=de543acd-64ae-4133-ba6f-301cfc35590f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FmqOiX4zsOJVRMhk5FuoA%2Fimage.png?alt=media&#x26;token=8fa1d0fe-1023-4ea9-acaa-5c29cc1527bc" alt=""><figcaption></figcaption></figure>

4. On the *Generate Keys* tab, once you've carefully reviewed the page, select **NEXT**.

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2F3LZ7g6slwnc2o9GyzDFd%2Fimage.png?alt=media&#x26;token=53e0ecd5-d58d-4ad9-b30e-126305887b12" alt=""><figcaption></figcaption></figure>

5. On the *Generate Access Token* tab, enter a valid description in the **Scopes** field. Select **NEXT**.

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FpxHSbwE59HLD4bCAqA5e%2Fimage.png?alt=media&#x26;token=ce2cbf8c-6043-49f8-9083-9b57df1e101a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2F0aI80JImMAb6sJoOvY1M%2Fimage.png?alt=media&#x26;token=fe36bd55-7a96-41fd-a934-b4a79816d8dc" alt=""><figcaption></figcaption></figure>

7. You can view your newly created subscription under the **Subscriptions** section.

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FsEHJNq01V5V5jYalVhvi%2FScreenshot%202023-03-08%20at%206.21.16%20PM.png?alt=media&#x26;token=0cf46b60-b31c-49ee-83a6-a7490229c285" alt=""><figcaption></figcaption></figure>
