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
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
["en"]
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
[ "fr_FR","en_US" ]
GET /data/1.0.0/countries HTTP/1.1
Host: api-public.socios.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
Successfully get countries
{
"data": [
{
"id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
"name": "France",
"iso2": "FR",
"iso3": "FRA"
}
]
}
[]
[]
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"
}
]
}
]
}
[]
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"
}
}
]
}
[]
[]
GET /data/1.0.0/sports HTTP/1.1
Host: api-public.socios.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
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"
}
}
Maximum number of returned records
1000
Field on which the records will be ordered
Sorting order
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
["en"]
[]
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
[ "fr_FR","en_US" ]
GET /data/1.0.0/leagues HTTP/1.1
Host: api-public.socios.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
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"
}
]
}
Last updated