API reference

Company dossier

Build a full company profile.

POST/api/v1/entity/dossier

Scope: dossier
Formats: JSON · SSE
Sandbox: Free fixtures

curl https://deepsearch.app/api/v1/entity/dossier \  -H "Authorization: Bearer $DEEPSEARCH_API_KEY" \  -H "Content-Type: application/json" \  -d '{        "company": {          "name": "Stripe",          "jurisdiction": "us_de"        }      }'

Example request

Authorization

Authorizationheaderrequired

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

Authentication guide

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

Bypass the shared cache 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.

Streaming & formats

{  "object": "entity_dossier_result",  "request_id": "req_01HZY8S4ENTITYDOSSIER9F4X9",  "cached": false,  "company": {    "entityId": "stripe-us-de",    "name": "Stripe",    "legalName": "Stripe, Inc.",    "status": "active",    "registration": {      "jurisdiction": "Delaware, US",      "entityType": "C Corporation",      "legalStatus": "Active"    },    "executives": [      {        "name": "Patrick Collison",        "title": "CEO"      }    ],    "summary": "Stripe is a payments company headquartered in San Francisco… [1]"  },  "metadata": {    "api_version": "v1",    "operation": "entity_dossier",    "request_id": "req_01HZY8S4ENTITYDOSSIER9F4X9",    "generated_at": "2026-10-01T12:00:00.000Z"  },  "usage": {    "metered": true,    "credits": 1,    "cached": false  },  "events": []}

Example responseapplication/json

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.

Usage & rate limits

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