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 countries

get

/countries

Authorizations

Query parameters

locales[]string[] · default: en

details[]string · enum[]

Header parameters

localestring · json

Locales used to translate the current entity (json array). If this HTTP header is not given or if it is an empty array, the query parameter locales will be used

Example: [ "fr_FR","en_US" ]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-public.socios.com/data/1.0.0/countries'

200

200

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

Successfully get countries

Endpoint to get all partner and fan token information

get

/fantokens

Authorizations

Query parameters

countries[]string[] · default:

currencyIds[]string[] · default:

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-public.socios.com/data/1.0.0/fantokens'

200

404

500

200

{
  "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"
        }
      ]
    }
  ]
}

Success

Endpoint to get all partner and fan token information

get

/fantokens/rate

Authorizations

Query parameters

currencyIds[]string[] · default:

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-public.socios.com/data/1.0.0/fantokens/rate'

200

500

200

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

Success

Endpoint to get the list of all available sports

get

/sports

Authorizations

Query parameters

pageinteger · integer

limitinteger · integer

orderBystring · enum

Options: id

cursorstring

directionstring · enum

Options: asc, ASC, DESC, desc

paginationModestring · enum

Options: detailed, simple

ids[]string[] · default:

namesstring

eventTypesstring

locales[]string[] · default:

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-public.socios.com/data/1.0.0/sports'

200

200

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

Successfully retrieved list of sports

Endpoint to get the list of all available leagues

get

/leagues

Authorizations

Query parameters

status[]string · enum[]

details[]string · enum[]

limitinteger · default: 1000

Maximum number of returned records

orderBystring

Field on which the records will be ordered

directionstring · enum

Sorting order

Options: asc, desc

locales[]string[] · default: en

namestring

sports[]string[] · default:

leagueCountryIso2Codesstring

leagueCountryIso3Codesstring

Header parameters

localestring · json

Locales used to translate the current entity (json array). If this HTTP header is not given or if it is an empty array, the query parameter locales will be used

Example: [ "fr_FR","en_US" ]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-public.socios.com/data/1.0.0/leagues'

200

200

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

Successfully retrieved list of leagues