Skip to main content
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

object
required
What you know about the record. Every field is optional; send as many as you have.
string
person or company. When omitted it is inferred: a person if email, linkedin_url or name is sent, otherwise a company.
boolean
default:"false"
When true, paid sources are asked if Agentic ID’s own records cannot resolve the record. Applies to people only. See Behaviour.
string
default:"b2b_outbound"
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.
integer
The most this call may charge. 0 to 100000. Never charged past it.

Response

string
required
The ID of this call. The same value as the X-Request-Id header.
string
required
One plain sentence saying what happened and what was charged.
object
required
string
required
One of:
string
The Agentic ID. Present for known and new when the call was allowed to charge for it.
string
What the match was made on, for example work_email, linkedin, domain, or source when a paid source resolved it.
number
Confidence of the link, from 0 to 1.
string
Why the outcome is what it is, when there is something to say.
object
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_credits is 1, or max_credits if that is lower.
  • If max_credits is reached, the ID is withheld, reason says so, and nothing is charged.
  • A record resolved through a paid source (spend: true) is charged at the same rate.
See Credits for how holds and charges work.

Errors

See Errors for the full list.

Behaviour

  • One record per call. Send one person or one company.
  • spend is off by default. Without it, only Agentic ID’s own records are used. With spend: true, a person that comes back unresolvable is 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 email or linkedin_url; name, company_name and company_domain are hints. A company is identified by company_domain; company_name is a hint.
  • Ambiguous records are not linked. review and conflict return 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.