Data API endpoints

The latest documentation for endpoints is always on the DevPortal: https://partner.socios.com/devportal/apis/3c83c678-b83c-47cd-a4ca-b27dcb19d643/test

Endpoint to get all partner and fan token information

GEThttps://api-public.socios.com/data/1.0.0/fantokens

Authorization

default

Query parameters

Response

200404500

Success

Body

application/json

dataarray of PartnerTokenDTO (object)

Request

JavaScriptCurl

const response = await fetch('https://api-public.socios.com/data/1.0.0/fantokens', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "partnerId": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "partnerName": "Team Vitality",
      "partnerShortName": "TV",
      "currencyId": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "tokenSymbol": "EUR",
      "mainColour": "FFFFFF",
      "country": "Malta",
      "images": [
        {
          "url": "https://url.com/partner/d66eb9d2-56c6-4b1b-8f56-31f8aa319abe/partner_logo/38aca876-86a8-4a10-a0e8-b0859614c8b3.png?version=1653577420",
          "type": "png",
          "format": "desktop",
          "width": "500",
          "height": "500"
        }
      ]
    }
  ]
}

Endpoint to currencies with their conversion rates to other currencies

GEThttps://api-public.socios.com/data/1.0.0/fantokens/rate

Authorization

default

Query parameters

Response

200404500

Success

Body

application/json

dataarray of PartnerConversionRates (object)

Request

JavaScriptCurl

const response = await fetch('https://api-public.socios.com/data/1.0.0/fantokens/rate', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "id": "b1181a62-9fd0-4290-ac29-32318bab3bab",
      "shortCode": "JUV",
      "conversionRates": {
        "EUR": "0.802418",
        "USD": "1.015128",
        "CHZ": "13.303533"
      }
    }
  ]
}

Endpoint to get all countries

GEThttps://api-public.socios.com/data/1.0.0/countries

Authorization

default

Query parameters

Header parameters

Response

200

Successfully get countries

Body

application/json

dataarray of CountryDTO (object)

Request

JavaScriptCurl

const response = await fetch('https://api-public.socios.com/data/1.0.0/countries', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "name": "France",
      "iso2": "FR",
      "iso3": "FRA"
    }
  ]
}

Endpoint to get the list of all available leagues

GEThttps://api-public.socios.com/data/1.0.0/leagues

Authorization

default

Query parameters

Header parameters

Response

200

Successfully retrieved list of leagues

Body

application/json

dataarray of LeagueDTO (one of)

Request

JavaScriptCurl

const response = await fetch('https://api-public.socios.com/data/1.0.0/leagues', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "name": "League name",
      "description": "Short description",
      "sportId": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "partnerIds": [
        "d36fe9b1-b524-4c82-a691-7b89cda36b4a"
      ],
      "countryISO2": "IT",
      "countryISO3": "ITA",
      "status": "active"
    }
  ]
}

Endpoint to get the list of all available sports

GEThttps://api-public.socios.com/data/1.0.0/sports

Authorization

default

Query parameters

Response

200

Successfully retrieved list of sports (simple paginationMode enabled)

Body

application/json

dataarray of SportListDTO (one of)

metadataone of

PaginationWithDetailedPaginationMode (object)PaginationWithSimplePaginationMode (object)

Request

JavaScriptCurl

const response = await fetch('https://api-public.socios.com/data/1.0.0/sports', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "name": "Sport name",
      "eventType": "match"
    }
  ],
  "metadata": {
    "total_items": 588,
    "current_page": 2,
    "last_page": 4,
    "cursor": "text"
  }
}