curl --request POST \
--url https://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"ipAddress": "<string>",
"observedAt": "2023-11-07T05:31:56Z",
"source": "<string>"
}
'import requests
url = "https://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry"
payload = {
"ipAddress": "<string>",
"observedAt": "2023-11-07T05:31:56Z",
"source": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({ipAddress: '<string>', observedAt: '2023-11-07T05:31:56Z', source: '<string>'})
};
fetch('https://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry', 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.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry",
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([
'ipAddress' => '<string>',
'observedAt' => '2023-11-07T05:31:56Z',
'source' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-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://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry"
payload := strings.NewReader("{\n \"ipAddress\": \"<string>\",\n \"observedAt\": \"2023-11-07T05:31:56Z\",\n \"source\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-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://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ipAddress\": \"<string>\",\n \"observedAt\": \"2023-11-07T05:31:56Z\",\n \"source\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ipAddress\": \"<string>\",\n \"observedAt\": \"2023-11-07T05:31:56Z\",\n \"source\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "accepted",
"id": "<string>",
"duplicate": true
}{
"error": "<string>",
"details": "<unknown>"
}{
"error": "<string>",
"details": "<unknown>"
}{
"error": "<string>",
"details": "<unknown>"
}{
"error": "<string>",
"details": "<unknown>"
}{
"error": "<string>",
"details": "<unknown>"
}Report Candidate IP Telemetry
Report an IP address your own systems observed for a candidate. Ropes stores the reading, enriches it with geolocation and network-concealment intelligence (VPN, proxy, Tor, relay, hosting), and plots it on the candidate’s Trust Center as an external source alongside the locations Ropes observed itself. Returns 202 as soon as the reading is stored; enrichment completes asynchronously, so a reading appears on the Trust Center shortly after this call rather than immediately. Reposting an identical (ipAddress, observedAt) pair for the same candidate is a no-op and returns duplicate: true, so retries are safe. The address must be publicly routable — a private, loopback, or link-local address means your system reported an internal IP rather than the public egress address, and is rejected.
Required scope: candidates:write
curl --request POST \
--url https://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"ipAddress": "<string>",
"observedAt": "2023-11-07T05:31:56Z",
"source": "<string>"
}
'import requests
url = "https://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry"
payload = {
"ipAddress": "<string>",
"observedAt": "2023-11-07T05:31:56Z",
"source": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({ipAddress: '<string>', observedAt: '2023-11-07T05:31:56Z', source: '<string>'})
};
fetch('https://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry', 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.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry",
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([
'ipAddress' => '<string>',
'observedAt' => '2023-11-07T05:31:56Z',
'source' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-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://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry"
payload := strings.NewReader("{\n \"ipAddress\": \"<string>\",\n \"observedAt\": \"2023-11-07T05:31:56Z\",\n \"source\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-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://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ipAddress\": \"<string>\",\n \"observedAt\": \"2023-11-07T05:31:56Z\",\n \"source\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ropes.ai/api/public/candidates/{candidateId}/ip-telemetry")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ipAddress\": \"<string>\",\n \"observedAt\": \"2023-11-07T05:31:56Z\",\n \"source\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "accepted",
"id": "<string>",
"duplicate": true
}{
"error": "<string>",
"details": "<unknown>"
}{
"error": "<string>",
"details": "<unknown>"
}{
"error": "<string>",
"details": "<unknown>"
}{
"error": "<string>",
"details": "<unknown>"
}{
"error": "<string>",
"details": "<unknown>"
}Authorizations
Each key carries scopes chosen when it is created: candidates:read, candidates:write, assessments:read, assessments:write, problems:read, problems:write, results:read. Keys created before scopes existed have full access. A request with a key that lacks an operation's scope returns 403 naming the missing scope.
Body
Response
Reading accepted for enrichment