Read the primary operating country
curl --request GET \
--url https://api.mysoleas.com/country/primary \
--header 'x-sp-auth-token: <api-key>'import requests
url = "https://api.mysoleas.com/country/primary"
headers = {"x-sp-auth-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-sp-auth-token': '<api-key>'}};
fetch('https://api.mysoleas.com/country/primary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mysoleas.com/country/primary",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-sp-auth-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.mysoleas.com/country/primary"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-sp-auth-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.mysoleas.com/country/primary")
.header("x-sp-auth-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mysoleas.com/country/primary")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-sp-auth-token"] = '<api-key>'
response = http.request(request)
puts response.read_bodyCatalog
Read the primary country
Return the primary operating country for the current tenant.
GET
/
country
/
primary
Read the primary operating country
curl --request GET \
--url https://api.mysoleas.com/country/primary \
--header 'x-sp-auth-token: <api-key>'import requests
url = "https://api.mysoleas.com/country/primary"
headers = {"x-sp-auth-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-sp-auth-token': '<api-key>'}};
fetch('https://api.mysoleas.com/country/primary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mysoleas.com/country/primary",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-sp-auth-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.mysoleas.com/country/primary"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-sp-auth-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.mysoleas.com/country/primary")
.header("x-sp-auth-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mysoleas.com/country/primary")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-sp-auth-token"] = '<api-key>'
response = http.request(request)
puts response.read_bodyThis route returns the
TenantCountry relation marked as primary for the tenant of the current token.
The primary country is used as the default context when some flows need to calculate fees or route a payment without a reliable explicit country.
If no primary country is configured on an older account, the response can contain data: null. In that case, existing flows keep their historical fallback.
{
"id": 42,
"is_primary": true,
"tenant": "tenant_123",
"Country": "CMR",
"updated_at": "2026-08-08 12:30:00"
}
Authorizations
Bearer token obtained with the client_id and client_secret of the application created in SoleasPay. Format: Bearer <access_token>.
Response
Pays primaire ou null
⌘I
