For AI agents: llms.txt.

Company dossier

Request example

POST/api/v1/entity/dossier
Scope
dossier
Formats
JSON · SSE
Sandbox
Free fixtures

Authorization

Authorizationheaderrequired

Send Bearer $DEEPSEARCH_API_KEY with the dossier scope. The free sandbox uses the published test key.

Body parameters

companyobjectrequired

The company to profile. Only company.name is required; pass the full hit from /entity/search to pin the exact entity.

company.namestringrequired

The company name.

refreshboolean

Skip this account's cached profile and rebuild (always meters).

Default: false

formatenum

json collects the result; sse streams progress and result events.

jsonsse

Default: json

sandboxboolean

Return deterministic, unmetered fixtures.

Default: false

Response

JSON responses preserve the operation result and include request metadata, usage, and collected events. SSE delivers progress and result events as they arrive.

Sources & coverage

Pass a company from /entity/search (or a minimal {name}) and get a structured business profile - registration, status, executives, estimated financials, funding, locations, corporate structure, and a written summary with cited sources. Public business records only; financial figures are estimates; not an FCRA report. Cached profiles are free.

Usage & caching

A fresh company profile is High usage and covers all nested work. Cached profiles use no usage.

Examples illustrate the contract. Test request runs the selected deployment; sandbox fixtures are unmetered.

Skip to content