Skip to main content
You need two things before you start:
  • Your server address. These pages write it as https://YOUR_AGENTIC_ID_HOST. Use the address your Agentic ID contact gave you.
  • A credential. An API key, or a sign-in with your iCustomer account.
The examples use placeholder names and domains (acme.example, alex.rivera@acme.example). Replace them with a real company domain and a real work email. A placeholder domain does not resolve, and validate refuses addresses on example.com and on reserved endings such as .example and .test before any paid check, with nothing charged.
1

Set your key and server

2

Resolve a company by domain

Keep the id. You use it with enrich, find, facts and the ledger.
3

Validate a work email

To retry a paid call safely, add an Idempotency-Key header. See Idempotency.

Read the answer

Every paid answer has the same three fields first.
string
Quote it when you report a problem.
string
One plain line saying what happened and what was charged.
object
quoted_credits is the most the call could have charged. charged_credits is what it did charge, never more than quoted.
For resolve, read outcome before you use id: For validate, each result has a verdict:

Next steps

Credits

What each call charges, and how to cap it.

What is an Agentic ID

The ID format, and which identifiers resolve to it.

Verification levels

How to read verified, corroborated and claimed.

API reference

Every endpoint, field and limit.