Get registration eligibility

curl --request GET \
  --url https://public-api.etoro.com/api/v1/registration/users/eligibility \
  --header 'X-Request-Id: <x-request-id>' \
  --header 'x-api-key: <api-key>' \
  --header 'x-user-key: <api-key>'

import requests

url = "https://public-api.etoro.com/api/v1/registration/users/eligibility"

headers = {
    "X-Request-Id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'X-Request-Id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>'
  }
};

fetch('https://public-api.etoro.com/api/v1/registration/users/eligibility', 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://public-api.etoro.com/api/v1/registration/users/eligibility",
  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-Request-Id: <x-request-id>",
    "x-api-key: <api-key>",
    "x-user-key: <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://public-api.etoro.com/api/v1/registration/users/eligibility"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Request-Id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<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://public-api.etoro.com/api/v1/registration/users/eligibility")
  .header("X-Request-Id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/registration/users/eligibility")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Request-Id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "countryIso": "GB",
  "currency": "USD",
  "eligibility": {
    "blocked": false,
    "restricted": false
  },
  "showNotificationsOptIn": true,
  "documents": [
    {
      "url": "https://www.etoro.com/legal/terms",
      "documentId": 42,
      "type": "TermsAndConditions"
    }
  ],
  "regulation": "FCA",
  "regionIsoCode": "EU"
}

GET

api

registration

users

eligibility

Get registration eligibility

curl --request GET \
  --url https://public-api.etoro.com/api/v1/registration/users/eligibility \
  --header 'X-Request-Id: <x-request-id>' \
  --header 'x-api-key: <api-key>' \
  --header 'x-user-key: <api-key>'

import requests

url = "https://public-api.etoro.com/api/v1/registration/users/eligibility"

headers = {
    "X-Request-Id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'X-Request-Id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>'
  }
};

fetch('https://public-api.etoro.com/api/v1/registration/users/eligibility', 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://public-api.etoro.com/api/v1/registration/users/eligibility",
  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-Request-Id: <x-request-id>",
    "x-api-key: <api-key>",
    "x-user-key: <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://public-api.etoro.com/api/v1/registration/users/eligibility"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Request-Id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<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://public-api.etoro.com/api/v1/registration/users/eligibility")
  .header("X-Request-Id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/registration/users/eligibility")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Request-Id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "countryIso": "GB",
  "currency": "USD",
  "eligibility": {
    "blocked": false,
    "restricted": false
  },
  "showNotificationsOptIn": true,
  "documents": [
    {
      "url": "https://www.etoro.com/legal/terms",
      "documentId": 42,
      "type": "TermsAndConditions"
    }
  ],
  "regulation": "FCA",
  "regionIsoCode": "EU"
}

Authorizations

x-api-key

string

header

default:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key

string

header

default:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Headers

X-Request-Id

string<uuid>

required

Query Parameters

countryIso

string

required

ISO 3166 country code (2 or 3 characters).

Response

Eligibility data returned successfully.

Partner eligibility response for a country.

countryIso

string

ISO 3166 country code.

Example:

"GB"

currency

string

Default currency ISO code for the country.

Example:

"USD"

eligibility

object

Country eligibility flags for partner registration.

Show child attributes

showNotificationsOptIn

boolean

Whether to show notifications opt-in during registration.

Example:

true

documents

object[]

Regulation documents required for registration.

Show child attributes

regulation

string

Regulation short name for the country.

Example:

"FCA"

regionIsoCode

string

Region ISO code when applicable.

Example:

"EU"

⌘I

Getting started

Partners API

Changelog

Get registration eligibility

Authorizations

Headers

Query Parameters

Response