API Reference
Get Entity
Retrieve full details for a specific business entity by ID, with optional federal data enrichment including SEC filings, lobbying disclosures, and government contracts.
Endpoint
GET /api/v1/entity/{id}Get full details for a specific business entity. Add ?include=federal to enrich with SEC filings, federal contracts, and lobbying disclosures (3 credits instead of 1).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | Entity ID from search results (UUID for DB states, STATE:id for Socrata states) |
include | string | no | Comma-separated enrichments. Currently supports: federal (adds SEC, contracts, lobbying data) |
Example Request
# Basic entity lookup (1 credit)
curl "https://filed.dev/api/v1/entity/ent_mNqR7xKp" \
-H "Authorization: Bearer fd_live_aBcDeFgH"
# With federal data enrichment (3 credits)
curl "https://filed.dev/api/v1/entity/NY:1393779?include=federal" \
-H "Authorization: Bearer fd_live_aBcDeFgH"import requests
headers = {"Authorization": "Bearer fd_live_aBcDeFgH"}
# Basic lookup
resp = requests.get(
"https://filed.dev/api/v1/entity/ent_mNqR7xKp",
headers=headers
)
# With federal enrichment
resp = requests.get(
"https://filed.dev/api/v1/entity/NY:1393779",
params={"include": "federal"},
headers=headers
)const headers = { Authorization: "Bearer fd_live_aBcDeFgH" };
// Basic lookup
const res = await fetch(
"https://filed.dev/api/v1/entity/ent_mNqR7xKp",
{ headers }
);
// With federal enrichment
const res2 = await fetch(
"https://filed.dev/api/v1/entity/NY:1393779?include=federal",
{ headers }
);// Basic lookup
req, _ := http.NewRequest("GET",
"https://filed.dev/api/v1/entity/ent_mNqR7xKp", nil)
req.Header.Set("Authorization", "Bearer fd_live_aBcDeFgH")
resp, _ := http.DefaultClient.Do(req)
// With federal enrichment
req2, _ := http.NewRequest("GET",
"https://filed.dev/api/v1/entity/NY:1393779?include=federal", nil)
req2.Header.Set("Authorization", "Bearer fd_live_aBcDeFgH")
resp2, _ := http.DefaultClient.Do(req2)Response
Response with ?include=federal:
{
"data": {
"id": "NY:1393779",
"name": "PFIZER H.C.P. CORPORATION",
"state": "NY",
"stateEntityId": "1393779",
"type": "Domestic Business Corporation",
"status": "Active",
"formedDate": "1953-06-02",
"registeredAgent": {
"name": "C T Corporation System",
"address": "28 Liberty Street, New York, NY 10005"
},
"officers": [],
"filings": [],
"federal": {
"sec": {
"items": [
{ "type": "10-K", "date": "2026-02-26", "description": "PFIZER INC" }
],
"totalCount": 7
},
"contracts": {
"items": [
{
"awardId": "W58P0524D0020",
"amount": 787274.80,
"agency": "Department of Defense",
"startDate": "2025-08-26"
}
],
"totalCount": 500
},
"lobbying": {
"items": [
{
"registrantName": "PFIZER INC",
"clientName": "PFIZER INC",
"amount": 2890000,
"issueArea": "Pharmaceutical Industry",
"filingDate": "2026-03-17"
}
],
"totalCount": 1730
}
}
},
"meta": {
"source": "New York Division of Corporations",
"lastUpdated": "2026-03-18T04:00:00Z",
"creditsUsed": 3,
"note": "Federal data included."
}
}Try It
Test this endpoint in the Playground.