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

Authorizations

Query parameters

locales[]string[] · default: en

Locales used to translate the current entity. Using the Locale HTTP header should be preferred. The HTTP header version is used in priority if it is given

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

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

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

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

Authorizations

Query parameters

status[]string · enum[]

Optional filter on league status

Example: created

details[]string · enum[]

flag to indicate if we need to include extra details

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

Locales used to translate the current entity. Using the Locale HTTP header should be preferred. The HTTP header version is used in priority if it is given

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",
      "partnerIds": [
        "d36fe9b1-b524-4c82-a691-7b89cda36b4a"
      ],
      "countryISO2": "IT",
      "countryISO3": "ITA",
      "status": "active"
    }
  ]
}

Successfully retrieved list of leagues