Skip to content
GridRouterhome

Search

Search providers, capabilities and pages

Resolve an identity API

people.identity.resolve

Link emails, phones, hashed identifiers and profiles that belong to one person.
providers document it
7

Providers

7 providers document resolve an identity in their own API docs. None routes it through GridRouter yet. Scores appear as calls are routed.

What counts as a hit:
At least one linked identifier is returned.

API

Same input for every provider. Set provider.sort to route by price, reliability or latency, or provider.only to pin providers; X-Grid-Max-Cost caps what one call can spend.

Inputs for people.identity.resolve
InputDescription
emailEmail or SHA-256 of it
phoneE.164 phone
Request
curl https://api.gridrouter.io/v1/run/people.identity.resolve \
  -H "Authorization: Bearer $GRID_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Grid-Max-Cost: 0.05" \
  -d '{"input":{"email":"dana@northwind.dev"},"provider":{"sort":"price"}}'

Fields

The normalized output every provider maps into. Suppliers come from integrated endpoint mappings (verified) or field names in each provider's API docs (claimed by the provider).

Every capability's fields
Output fields for Resolve an identity
FieldTypePIIDescriptionSupplied by
person_idstringIdentifierVendor's person identifierAI Ark
emailsarray<string>Personal contactLinked email addressesNot mapped yet
phonesarray<string>Personal contactLinked phone numbersNot mapped yet
hashed_emailsarray<string>IdentifierSHA-256 or MD5 email hashesNot mapped yet
linkedin_urlstring · linkedin_urlIdentifierLinked profile URLAI Ark
match_confidencenumberNoneMatch confidence 0-1Not mapped yet