Search Entities

Search business entities by name, registered agent, and state. Filter by status and entity type with pagination support.

Endpoint

GET /api/v1/search

Search business entities by name, registered agent, and state. Returns matching entities with basic details. Costs 1 credit per request (see Credits for exceptions).

Parameters

Name	Type	Required	Description
`name`	string	conditional	Business name to search for (required if `agent` not provided)
`state`	string	no	Two-letter state code (e.g., FL, NY, CT). Omit to search across all states (5 credits).
`agent`	string	conditional	Registered agent name to search for
`status`	string	no	Filter by status: active, inactive, all (default: all)
`type`	string	no	Filter by entity type: llc, corporation, lp
`exact`	boolean	no	`true` to require an exact name match instead of a prefix/fuzzy search
`formed_after`	string	no	Return only entities formed after this date (ISO 8601, e.g., `2010-01-01`)
`formed_before`	string	no	Return only entities formed before this date (ISO 8601)
`filing_number`	string	no	Search by state-assigned filing number
`officer`	string	no	Search by officer name (5 credits)
`limit`	integer	no	Results per page, max 50 (default: 10)
`offset`	integer	no	Pagination offset (default: 0)

Credits

Most searches cost 1 credit. Two cases cost 5 credits:

Cross-state search — omitting state searches all covered states simultaneously.
Officer search — passing officer searches officer/director records across entities.

Example Request

cURL

curl "https://filed.dev/api/v1/search?name=Acme&state=FL" \
  -H "Authorization: Bearer fd_live_aBcDeFgH"

# Search by registered agent
curl "https://filed.dev/api/v1/search?agent=CSC+Global&state=FL" \
  -H "Authorization: Bearer fd_live_aBcDeFgH"

Python

import requests

# Search by name
resp = requests.get(
    "https://filed.dev/api/v1/search",
    params={"name": "Acme", "state": "FL"},
    headers={"Authorization": "Bearer fd_live_aBcDeFgH"}
)

# Search by registered agent
resp = requests.get(
    "https://filed.dev/api/v1/search",
    params={"agent": "CSC Global", "state": "FL"},
    headers={"Authorization": "Bearer fd_live_aBcDeFgH"}
)

Node.js

// Search by name
const res = await fetch(
  "https://filed.dev/api/v1/search?name=Acme&state=FL",
  { headers: { Authorization: "Bearer fd_live_aBcDeFgH" } }
);

// Search by registered agent
const res2 = await fetch(
  "https://filed.dev/api/v1/search?agent=CSC+Global&state=FL",
  { headers: { Authorization: "Bearer fd_live_aBcDeFgH" } }
);

// Search by name
req, _ := http.NewRequest("GET",
  "https://filed.dev/api/v1/search?name=Acme&state=FL", nil)
req.Header.Set("Authorization", "Bearer fd_live_aBcDeFgH")
resp, _ := http.DefaultClient.Do(req)

// Search by registered agent
req2, _ := http.NewRequest("GET",
  "https://filed.dev/api/v1/search?agent=CSC+Global&state=FL", nil)
req2.Header.Set("Authorization", "Bearer fd_live_aBcDeFgH")
resp2, _ := http.DefaultClient.Do(req2)

Response

{
  "data": [
    {
      "id": "ent_mNqR7xKp",
      "name": "ACME HOLDINGS LLC",
      "state": "FL",
      "type": "LLC",
      "status": "Active",
      "formedDate": "2019-03-14",
      "registeredAgent": {
        "name": "CSC Global",
        "address": "1234 Main St, Tallahassee, FL 32301"
      },
      "principalAddress": "123 Main St, Miami, FL 33101",
      "officerCount": 3,
      "lastUpdated": "2026-02-27T12:00:00Z"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 10,
    "offset": 0,
    "state": "FL",
    "source": "Florida Division of Corporations"
  }
}

Try It

Test this endpoint in the Playground — no code required.