Agent API

Give your AI agent access to the right decision maker.

One API for objective resolution, company intelligence, decision-maker discovery, verification, and evidence. Real research behind every response, never a database lookup dressed up as one.

Real request, against this API
curl https://aidealigence.com/api/v1/objectives \
  -H "Authorization: Bearer dl_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "objective": "Find investors in Dubai and Singapore
     capable of investing 10 million or more in growth-stage fintech"
  }'
201 Created
{
  "id": "b1a2...",
  "status": "researching",
  "objective": "Find the person responsible...",
  "recommendations": []
}

// then poll GET /v1/objectives/{id} until
// status is "completed" or "failed"

Endpoints

POST/v1/keys

Create an API key (JWT-authenticated).

POST/v1/objectives

Resolve a business objective to ranked, evidence-backed people.

POST/v1/objectives/estimate

Preflight cost: estimated credits, £ cost, and latency — before you spend anything.

POST/v1/objectives/quick

Fewer sources, lower cost, faster — same real pipeline, smaller scope.

POST/v1/objectives/deep

More sources, more candidates compared, higher cost — the thorough pass.

GET/v1/objectives/{id}

Check status and, once complete, results.

GET/v1/objectives/{id}/results

Fetch the finished recommendations.

POST/v1/objectives/{id}/cancel

Stop a running objective — halts real spend, not just a status flag.

POST/v1/objectives/{id}/refresh

Re-run an objective from scratch for current results. Billed like a new run.

POST/v1/people/resolve

Find the person at a company responsible for an objective.

POST/v1/companies/resolve

Find organisations relevant to an objective.

POST/v1/functions/resolve

Determine the responsible function — fast, one call.

POST/v1/verify

Verify a previously-found person still holds their role.

GET/v1/evidence/{id}

Retrieve the evidence behind a claim.

POST/v1/access/resolve

Get a legitimate route to reach a person.

POST/v1/batch/objectives

Resolve several objectives together.

GET/v1/batch/{id}

Aggregate status across a batch.

GET/v1/batch/{id}/results

Full results for every objective in a batch.

POST/v1/webhooks

Register a URL for objective.completed / .failed / batch.completed.

Objective/people/company resolution runs real research and is asynchronous — expect it to take minutes, not milliseconds. Verify, evidence, access, and functions/resolve are fast, synchronous calls.

What every response guarantees

  • Never a fabricated contact detail
  • Explicit verified / likely / uncertain / not_found states
  • Evidence attached to every claim
  • Structured JSON, never marketing language to parse