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[]optional

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

Default: ["en"]

details[]string · enum[]optional

Header parameters

localestring · jsonoptional

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[]optionalDefault: []

currencyIds[]string[]optionalDefault: []

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[]optionalDefault: []

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 · integeroptional

limitinteger · integeroptional

orderBystring · enumoptionalAvailable options:

cursorstringoptional

directionstring · enumoptionalAvailable options:

paginationModestring · enumoptionalAvailable options:

ids[]string[]optionalDefault: []

namesstringoptional

eventTypesstringoptional

locales[]string[]optionalDefault: []

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

Optional filter on league status

Example: created

details[]string · enum[]optional

flag to indicate if we need to include extra details

limitintegeroptional

Maximum number of returned records

Default: 1000

orderBystringoptional

Field on which the records will be ordered

directionstring · enumoptional

Sorting order

Available options:

locales[]string[]optional

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

Default: ["en"]

namestringoptional

sports[]string[]optionalDefault: []

leagueCountryIso2Codesstringoptional

leagueCountryIso3Codesstringoptional

Header parameters

localestring · jsonoptional

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