Submit KYC Questionnaire Answers

curl --request POST \
  --url https://public-api.etoro.com/api/v1/kyc-data/questionnaire \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "answers": [
    {
      "questionId": 101,
      "answerIds": [
        11,
        12
      ],
      "freeTexts": [
        {
          "answerId": 12,
          "text": "Freelance software development"
        }
      ]
    },
    {
      "questionId": 102,
      "answerIds": [
        21
      ],
      "freeTexts": []
    }
  ]
}
'

import requests

url = "https://public-api.etoro.com/api/v1/kyc-data/questionnaire"

payload = { "answers": [
        {
            "questionId": 101,
            "answerIds": [11, 12],
            "freeTexts": [
                {
                    "answerId": 12,
                    "text": "Freelance software development"
                }
            ]
        },
        {
            "questionId": 102,
            "answerIds": [21],
            "freeTexts": []
        }
    ] }
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    answers: [
      {
        questionId: 101,
        answerIds: [11, 12],
        freeTexts: [{answerId: 12, text: 'Freelance software development'}]
      },
      {questionId: 102, answerIds: [21], freeTexts: []}
    ]
  })
};

fetch('https://public-api.etoro.com/api/v1/kyc-data/questionnaire', 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/kyc-data/questionnaire",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'answers' => [
        [
                'questionId' => 101,
                'answerIds' => [
                                11,
                                12
                ],
                'freeTexts' => [
                                [
                                                                'answerId' => 12,
                                                                'text' => 'Freelance software development'
                                ]
                ]
        ],
        [
                'questionId' => 102,
                'answerIds' => [
                                21
                ],
                'freeTexts' => [
                                
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-request-id: <x-request-id>",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/kyc-data/questionnaire"

	payload := strings.NewReader("{\n  \"answers\": [\n    {\n      \"questionId\": 101,\n      \"answerIds\": [\n        11,\n        12\n      ],\n      \"freeTexts\": [\n        {\n          \"answerId\": 12,\n          \"text\": \"Freelance software development\"\n        }\n      ]\n    },\n    {\n      \"questionId\": 102,\n      \"answerIds\": [\n        21\n      ],\n      \"freeTexts\": []\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	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>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v1/kyc-data/questionnaire")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"answers\": [\n    {\n      \"questionId\": 101,\n      \"answerIds\": [\n        11,\n        12\n      ],\n      \"freeTexts\": [\n        {\n          \"answerId\": 12,\n          \"text\": \"Freelance software development\"\n        }\n      ]\n    },\n    {\n      \"questionId\": 102,\n      \"answerIds\": [\n        21\n      ],\n      \"freeTexts\": []\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/kyc-data/questionnaire")

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

request = Net::HTTP::Post.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"answers\": [\n    {\n      \"questionId\": 101,\n      \"answerIds\": [\n        11,\n        12\n      ],\n      \"freeTexts\": [\n        {\n          \"answerId\": 12,\n          \"text\": \"Freelance software development\"\n        }\n      ]\n    },\n    {\n      \"questionId\": 102,\n      \"answerIds\": [\n        21\n      ],\n      \"freeTexts\": []\n    }\n  ]\n}"

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

{
  "results": [
    {
      "questionId": 101,
      "status": "Accepted"
    },
    {
      "questionId": 102,
      "status": "Accepted"
    }
  ],
  "successCount": 2,
  "failureCount": 0
}

KYC

Submit KYC Questionnaire Answers

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

Submits the authenticated user’s answers to the KYC questionnaire in a single request. Each answer is applied individually upstream. Returns 200 when every answer is accepted; returns 422 when one or more answers are rejected (partial or full), with a per-question breakdown serialized as a JSON string into error.details. A 207 Multi-Status response is never returned.

POST

api

kyc-data

questionnaire

Submit KYC Questionnaire Answers

curl --request POST \
  --url https://public-api.etoro.com/api/v1/kyc-data/questionnaire \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "answers": [
    {
      "questionId": 101,
      "answerIds": [
        11,
        12
      ],
      "freeTexts": [
        {
          "answerId": 12,
          "text": "Freelance software development"
        }
      ]
    },
    {
      "questionId": 102,
      "answerIds": [
        21
      ],
      "freeTexts": []
    }
  ]
}
'

import requests

url = "https://public-api.etoro.com/api/v1/kyc-data/questionnaire"

payload = { "answers": [
        {
            "questionId": 101,
            "answerIds": [11, 12],
            "freeTexts": [
                {
                    "answerId": 12,
                    "text": "Freelance software development"
                }
            ]
        },
        {
            "questionId": 102,
            "answerIds": [21],
            "freeTexts": []
        }
    ] }
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    answers: [
      {
        questionId: 101,
        answerIds: [11, 12],
        freeTexts: [{answerId: 12, text: 'Freelance software development'}]
      },
      {questionId: 102, answerIds: [21], freeTexts: []}
    ]
  })
};

fetch('https://public-api.etoro.com/api/v1/kyc-data/questionnaire', 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/kyc-data/questionnaire",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'answers' => [
        [
                'questionId' => 101,
                'answerIds' => [
                                11,
                                12
                ],
                'freeTexts' => [
                                [
                                                                'answerId' => 12,
                                                                'text' => 'Freelance software development'
                                ]
                ]
        ],
        [
                'questionId' => 102,
                'answerIds' => [
                                21
                ],
                'freeTexts' => [
                                
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-request-id: <x-request-id>",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/kyc-data/questionnaire"

	payload := strings.NewReader("{\n  \"answers\": [\n    {\n      \"questionId\": 101,\n      \"answerIds\": [\n        11,\n        12\n      ],\n      \"freeTexts\": [\n        {\n          \"answerId\": 12,\n          \"text\": \"Freelance software development\"\n        }\n      ]\n    },\n    {\n      \"questionId\": 102,\n      \"answerIds\": [\n        21\n      ],\n      \"freeTexts\": []\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	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>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v1/kyc-data/questionnaire")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"answers\": [\n    {\n      \"questionId\": 101,\n      \"answerIds\": [\n        11,\n        12\n      ],\n      \"freeTexts\": [\n        {\n          \"answerId\": 12,\n          \"text\": \"Freelance software development\"\n        }\n      ]\n    },\n    {\n      \"questionId\": 102,\n      \"answerIds\": [\n        21\n      ],\n      \"freeTexts\": []\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/kyc-data/questionnaire")

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

request = Net::HTTP::Post.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"answers\": [\n    {\n      \"questionId\": 101,\n      \"answerIds\": [\n        11,\n        12\n      ],\n      \"freeTexts\": [\n        {\n          \"answerId\": 12,\n          \"text\": \"Freelance software development\"\n        }\n      ]\n    },\n    {\n      \"questionId\": 102,\n      \"answerIds\": [\n        21\n      ],\n      \"freeTexts\": []\n    }\n  ]\n}"

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

{
  "results": [
    {
      "questionId": 101,
      "status": "Accepted"
    },
    {
      "questionId": 102,
      "status": "Accepted"
    }
  ],
  "successCount": 2,
  "failureCount": 0
}

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

A unique request identifier.

Example:

"73bb69b8-72ea-4f80-b7f9-e71398392780"

Body

application/json

answers

object[]

List of answers to submit, one entry per question.

Show child attributes

Response

All submitted answers were accepted. Returns a per-question breakdown with counts.

Per-question outcome of a bulk questionnaire submission.

results

object[]

Per-question result entries.

Show child attributes

successCount

integer<int32>

Number of answers that were accepted.

failureCount

integer<int32>

Number of answers that failed.

⌘I

Getting started

Partners API

Changelog

Submit KYC Questionnaire Answers

Authorizations

Headers

Body

Response