Look up a known person

curl --request POST \
  --url https://api.outreign.io/rest-api/people/lookup \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "full_name": "Jordan Lee",
  "company": "Northwind Analytics"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({full_name: 'Jordan Lee', company: 'Northwind Analytics'})
};

fetch('https://api.outreign.io/rest-api/people/lookup', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.outreign.io/rest-api/people/lookup"

payload = {
    "full_name": "Jordan Lee",
    "company": "Northwind Analytics"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "person": null,
  "error": "No matching contact found"
}

{
  "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": "Rate limit exceeded",
  "resetAt": "2026-11-06T06:01:00.000Z"
}

{
  "error": "Internal server error"
}