Research a saved lead

curl --request POST \
  --url https://api.outreign.io/rest-api/leads/{id}/research \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "force": false
}'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({force: false})
};

fetch('https://api.outreign.io/rest-api/leads/{id}/research', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.outreign.io/rest-api/leads/{id}/research"

payload = { "force": False }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "brief": {
    "what_they_do": "",
    "observations": [],
    "confidence": "low"
  },
  "sources": [],
  "confidence": "low",
  "cached": false
}

{
  "error": "contact_name and company_name are required"
}

{
  "error": "Invalid API key"
}

{
  "error": "API access is included on Starter and above. Upgrade your plan to use the API."
}

{
  "error": "Not found"
}

{
  "error": "Rate limit exceeded",
  "resetAt": "2026-11-06T06:01:00.000Z"
}

{
  "error": "Internal server error"
}