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

https://api-public.socios.com/data/1.0.0http://api-public.socios.com/data/1.0.0

/countries

Authorizations

default

OAuth2implicitRequired

Authorization URL:

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

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

200

Successfully get countries

application/json

get

/countries

HTTPcURLJavaScriptPython

GET /data/1.0.0/countries HTTP/1.1
Host: api-public.socios.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

Successfully get countries

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

Endpoint to get all partner and fan token information

get

https://api-public.socios.com/data/1.0.0http://api-public.socios.com/data/1.0.0

/fantokens

Authorizations

default

OAuth2implicitRequired

Authorization URL:

Query parameters

countries[]string[]OptionalDefault: []

currencyIds[]string[]OptionalDefault: []

Responses

200

Success

application/json

404

Entity not found

application/json

500

Internal Server Error

application/json

get

/fantokens

HTTPcURLJavaScriptPython

GET /data/1.0.0/fantokens HTTP/1.1
Host: api-public.socios.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "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 get all partner and fan token information

get

https://api-public.socios.com/data/1.0.0http://api-public.socios.com/data/1.0.0

/fantokens/rate

Authorizations

default

OAuth2implicitRequired

Authorization URL:

Query parameters

currencyIds[]string[]OptionalDefault: []

Responses

200

Success

application/json

500

Internal Server Error

application/json

get

/fantokens/rate

HTTPcURLJavaScriptPython

GET /data/1.0.0/fantokens/rate HTTP/1.1
Host: api-public.socios.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Endpoint to get the list of all available sports

get

https://api-public.socios.com/data/1.0.0http://api-public.socios.com/data/1.0.0

/sports

Authorizations

default

OAuth2implicitRequired

Authorization URL:

Query parameters

pageinteger · integerOptional

limitinteger · integerOptional

orderBystring · enumOptionalPossible values:

cursorstringOptional

directionstring · enumOptionalPossible values:

paginationModestring · enumOptionalPossible values:

ids[]string[]OptionalDefault: []

namesstringOptional

eventTypesstringOptional

locales[]string[]OptionalDefault: []

Responses

200

Successfully retrieved list of sports

application/json

get

/sports

HTTPcURLJavaScriptPython

GET /data/1.0.0/sports HTTP/1.1
Host: api-public.socios.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

Successfully retrieved list of sports

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

Endpoint to get the list of all available leagues

get

https://api-public.socios.com/data/1.0.0http://api-public.socios.com/data/1.0.0

/leagues

Authorizations

default

OAuth2implicitRequired

Authorization URL:

Query parameters

limitintegerOptional

Maximum number of returned records

Default: 1000

orderBystringOptional

Field on which the records will be ordered

directionstring · enumOptional

Sorting order

Possible values:

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

200

Successfully retrieved list of leagues

application/json

get

/leagues

HTTPcURLJavaScriptPython

GET /data/1.0.0/leagues HTTP/1.1
Host: api-public.socios.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

Successfully retrieved list of leagues

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