Entity record · sample data
ACME HOLDINGS, INC.
- Entity ID
- 1234567
- Type
- Domestic business corporation
- State
- New York
- Formed
- 2007-03-26
- Registered agent
- Example Registered Agent, Inc.
Albany, NY
POST /api/v1/entities
1.2 s · 2 records
Registry records, billed per record.
United States, Finland and Russia: official registries and open data behind one key. Each lookup queries the source when you ask, and you only pay for the records that come back.
From $0.005 a record. Prepaid credits from $50, no subscription.
# Search a name across state registries
curl -X POST https://docket.rest/api/v1/entities \
-H "Authorization: Bearer $DOCKET_KEY" \
-H "content-type: application/json" \
-d '{"name": "Acme Holdings", "states": ["NY", "CO"], "limit": 5}'
# Or SEC filings by ticker
curl -X POST https://docket.rest/api/v1/sec-filings \
-H "Authorization: Bearer $DOCKET_KEY" \
-d '{"ticker": "AAPL", "form_types": ["10-K"], "limit": 3}'
# Or as a query string
curl "https://docket.rest/api/v1/entities?name=Acme&states=NY&limit=5" \
-H "Authorization: Bearer $DOCKET_KEY"{
"status": "success",
"api": "entities",
"total_results": 2,
"latency_ms": 1210,
"credits": {
"cost": "$0.020",
"remaining_balance": "$49.9800"
},
"results": [
{
"state": "NY",
"entity_id": "1234567",
"name": "ACME HOLDINGS, INC.",
"formed": "2007-03-26"
},
{
"…": "1 more"
}
]
}6 lookups, one key
Each API is a single endpoint with a flat price per record returned.
United States
US state entities
Search a business name across state business registries (NY, CO, OR, CT): type, status, formation date and address.
POST /api/v1/entities
{"name":"Stripe","states":["NY","CO"],"limit":3}
$0.01per entity
United States
SEC filings
Recent SEC EDGAR filings (10-K, 10-Q, 8-K and more) for a ticker, CIK or company name.
POST /api/v1/sec-filings
{"ticker":"AAPL","form_types":["10-K"],"limit":3}
$0.005per filing
Worldwide
Global entities (LEI)
Legal entities in any country that hold a Legal Entity Identifier: status, local register number (e.g. German HRB, Japanese corporate number) and addresses. Covers listed, regulated and larger companies, not every small business.
POST /api/v1/lei
{"name":"Siemens","country":"DE","limit":3}
$0.01per entity
Finland
Finland PRH
Finnish companies from the official PRH/YTJ register by name, business ID, town or legal form.
POST /api/v1/finland
{"name":"Nokia","limit":3}
$0.01per company
Russia
Russia EGRUL
Russian legal entities and sole traders from the Federal Tax Service registry, by INN, OGRN or name.
POST /api/v1/russia
{"query":"7736207543","limit":3}
$0.03per entity
Worldwide
Contact finder
Reads a company's own site (home, contact and about pages) for emails, phone numbers and social profiles, with a mail-server check on each email domain.
POST /api/v1/contacts
{"url":"https://stripe.com"}
$0.02per site
You pay for what comes back
- Reserve. We hold the price of the most records your limit allows, so parallel requests cannot overspend.
- Look up. The source is queried when you ask.
- Settle. Anything it does not return goes back to your balance. No matches costs nothing.
Prepaid credits from $50. The ledger shows every charge and refund.
US state entities, limit 5
worked example
| Balance before | $50.00 | |
| Reserve 5 × $0.01 | limit: 5 | −$0.05 |
| The registry returns | 2 records | |
| Refund 3 unused | 3 × $0.01 | +$0.03 |
| You were charged | 2 × $0.01 | $0.02 |
| Balance after | $49.98 |
The same envelope every time
Whichever API you call, the response has the same five fields, so one parser covers all of them.
- status
- "success" on any 200
- total_results
- Records returned and billed
- latency_ms
- How long the live lookup took
- credits
- What this call cost, and your balance after it
- results
- The records, as published by the registry
Multi-state search at $0.01 a record
const res = await fetch("https://docket.rest/api/v1/entities", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DOCKET_KEY}`,
"content-type": "application/json",
},
body: JSON.stringify({
name: "Acme",
states: ["NY", "CO", "OR"],
limit: 3,
}),
});
const { results, credits } = await res.json();
console.log(results.length, "records, charged", credits.cost);Questions
Where does the data come from?
Each API reads an official public source: SEC EDGAR, state open-data portals, Finland's PRH register, the Russian Federal Tax Service and the GLEIF global index, depending on the API. We do not keep copies, but state open-data portals refresh daily to weekly, so a brand-new filing can lag. Docket is not affiliated with any agency; confirm records you rely on with the source.
What if nothing matches?
You get a 200 with an empty results list and you are not charged. The reservation for that request goes straight back to your balance.
Why am I charged before the lookup runs?
So two requests sent at the same moment can never spend the same dollars. We hold the price of the most records your limit allows, then refund whatever the registry does not return.
How long does a lookup take?
Several seconds, sometimes longer. The sources are queried when you ask and some are slow (the Finnish register can take several seconds), so set a generous timeout and treat each call as a lookup, not a page load.
What happens if a registry is down?
You get a 502 and the whole reservation is refunded. Both the charge and the refund show on your ledger.
How do I pay?
Prepaid credits through Polar, from $50. There is no subscription. Receipts and invoices are in the billing portal.