Trade an address, name, phone, or email for a scored dossier — live phone numbers, emails, a full residency timeline, and everyone connected. One call, JSON out.
curl -X POST https://metorys.com/api/v1/search \
-H "Authorization: Bearer aegis_sk_..." \
-H "Content-Type: application/json" \
-d '{
"query": "1233 Silver Arrow Ct, Fort Mill SC",
"fields": ["name", "phone", "email"],
"maxResults": 2
}'Search by address, name, phone, or email through a single POST. Aegis detects the mode and returns the same structured dossier.
API searches spend the same credits as the dashboard. There's no separate API plan and no surprise metering — a hit costs what a hit costs.
Every phone comes with a confidence score and line type; addresses carry date ranges; relatives and associates come pre-separated. JSON you can act on.
The API runs the exact resolution path as the product — archive-first, live on a miss — so what you build on matches what you see in the app.
From zero to your first traced record in a few minutes.
Open the API section of your dashboard and generate a key. It's shown once — store it as a secret.
Get your API keyPOST a query with your key in the Authorization header. Optionally pass the fields you want and how many results to return.
You get back scored contacts and a residency timeline, plus how many credits the call used and your remaining balance.
curl -X POST https://metorys.com/api/v1/search \
-H "Authorization: Bearer aegis_sk_..." \
-H "Content-Type: application/json" \
-d '{
"query": "1233 Silver Arrow Ct, Fort Mill SC",
"fields": ["name", "phone", "email"],
"maxResults": 2
}'{
"query": { "input": "1233 Silver Arrow Ct...", "mode": "address" },
"results": [
{
"status": "found",
"rank": 1,
"person": {
"firstName": "Robert", "lastName": "Ledbetter",
"phones": [{ "display": "(828) 555-0104",
"type": "Wireless", "confidence": 94 }],
"emails": [{ "address": "r.ledbetter@gmail.com" }]
}
}
],
"creditsUsed": 4,
"creditsRemaining": 46
}Want every field, error code, and credit rule? Read the full reference →
Generate a key from your dashboard and make your first call in minutes. Included on Pro — no per-call fee.