Filed — Business Entity Lookup#

Search 1.9M+ US business entities from official state records.

Setup#

An API key is required. Get one free (100 lookups/month) at https://filed.dev/register

Store the key in environment variable FILED_API_KEY or pass via --api-key.

Quick Reference#

bash

# Search by business name
scripts/filed.sh search --name "Acme Holdings" --state FL

# Search by registered agent
scripts/filed.sh search --agent "CSC Global" --state FL

# Search by officer name
scripts/filed.sh search --officer "John Smith" --state NY

# Get full entity details (officers, filings, addresses)
scripts/filed.sh entity ent_mNqR7xKp

# Filter by status and type
scripts/filed.sh search --name "Acme" --state FL --status active --type llc

# Filter by formation date
scripts/filed.sh search --name "Acme" --state FL --formed-after 2020-01-01

Supported States#

FL, NY, PA, CT, CO, OR, IA, AK — more added regularly.

Response Fields#

Search results return: id, name, state, type, status, formedDate, registeredAgent (name + address), principalAddress, officerCount.

Entity details add: stateEntityId, officers[] (name + title), filings[] (type + date).

Paid Plans#

PlanLookups/monthPriceFree100$0Pro1,000$49/moUltra10,000$199/moMega50,000$499/mo

Upgrade at https://filed.dev/pricing or via RapidAPI: https://rapidapi.com/grantley-holdings-grantley-holdings-default/api/filed2

API Details#

For full endpoint docs, parameter reference, and error codes: references/api-docs.md