POST /v1/resolve answers one question: which Agentic ID does this record belong to? Send what you know about one person or one company and get back its ID, how it was matched, and what the call cost. Use it to key your own records, to remove duplicates before you spend on other calls, and to get the ID that Feedback and Find accept.
200
The domains on this page are reserved for documentation. Use a real record to see a match.
Request
person or company. When omitted it is inferred: a person if email, linkedin_url or name is sent, otherwise a company.When
true, paid sources are asked if Agentic ID’s own records cannot resolve the record. Applies to people only. See Behaviour.Why you are asking. One of
b2b_outbound, ad_audience, own_customer_enrichment, fraud_check. The call is refused if your workspace has not allowed the purpose.Response
What the match was made on, for example
work_email, linkedin, domain, or source when a paid source resolved it.What the ID stands for, as far as the request said. Present when
id is present. A person is never described here.Companies that may belong with this one, such as a regional site or a brand. Linked for review, never merged.
What it costs
quoted_creditsis 1, ormax_creditsif that is lower.- If
max_creditsis reached, the ID is withheld,reasonsays so, and nothing is charged. - A record resolved through a paid source (
spend: true) is charged at the same rate.
Errors
See Errors for the full list.
Behaviour
- One record per call. Send one person or one company.
spendis off by default. Without it, only Agentic ID’s own records are used. Withspend: true, a person that comes backunresolvableis looked up in paid sources. Companies are not looked up this way: they resolve by domain.- People and companies use different fields. A person is identified by
emailorlinkedin_url;name,company_nameandcompany_domainare hints. A company is identified bycompany_domain;company_nameis a hint. - Ambiguous records are not linked.
reviewandconflictreturn no ID and no charge. - IDs your workspace holds. A resolved ID is held by your workspace. Feedback and the facts and ledger endpoints accept only IDs your workspace holds.

