API Documentation

Base URL: https://filed.dev

Authentication

All requests require an API key passed via the Authorization header.

Authorization: Bearer fd_live_your_api_key

API keys start with fd_live_ for production or fd_test_ for testing.

Rate Limits

Plan	Monthly Lookups	Rate Limit
Free	100	10 req/min
Starter	1,000	60 req/min
Growth	10,000	120 req/min

Rate limit headers are included in every response:X-RateLimit-Remaining,X-RateLimit-Reset

GET/v1/search

Search business entities by name and state

Parameters

Name	Type	Required	Description
name	string	required	Business name to search for
state	string	required	Two-letter state code (e.g., MD, VA, DC)
status	string	optional	Filter by status: active, inactive, all (default: all)
type	string	optional	Filter by entity type: llc, corporation, lp
limit	integer	optional	Results per page, max 50 (default: 10)
offset	integer	optional	Pagination offset (default: 0)

Example Request

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

Example Response

{
  "data": [
    {
      "id": "ent_mNqR7xKp",
      "name": "ACME HOLDINGS LLC",
      "state": "MD",
      "type": "LLC",
      "status": "Active",
      "formedDate": "2019-03-14"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

GET/v1/entity/{id}

Get full details for a specific business entity

Parameters

Name	Type	Required	Description
id	string	required	Entity ID returned from search

Example Request

curl "https://filed.dev/v1/entity/ent_mNqR7xKp" \
  -H "Authorization: Bearer fd_live_aBcDeFgH"

Example Response

{
  "data": {
    "id": "ent_mNqR7xKp",
    "name": "ACME HOLDINGS LLC",
    "state": "MD",
    "stateEntityId": "W18394756",
    "type": "LLC",
    "status": "Active",
    "formedDate": "2019-03-14",
    "registeredAgent": {
      "name": "CSC Global",
      "address": "7 St Paul St, Baltimore, MD 21202"
    },
    "principalAddress": "123 Main St, Bethesda, MD 20814",
    "officers": [
      {
        "name": "John Smith",
        "title": "Member/Manager"
      }
    ],
    "filings": [
      {
        "type": "Annual Report",
        "date": "2025-11-01"
      },
      {
        "type": "Articles of Organization",
        "date": "2019-03-14"
      }
    ]
  },
  "meta": {
    "source": "Maryland SDAT",
    "lastUpdated": "2026-02-27T12:00:00Z"
  }
}

Errors

Filed uses standard HTTP status codes. Errors include a JSON body with details.

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "You have exceeded your monthly lookup limit.",
    "limit": 100,
    "reset": "2026-03-01T00:00:00Z"
  }
}

Status	Code	Description
400	invalid_params	Missing or invalid query parameters
401	unauthorized	Missing or invalid API key
404	not_found	Entity not found
429	rate_limit_exceeded	Monthly or per-minute limit exceeded
500	internal_error	Something went wrong on our end
503	state_unavailable	State data source temporarily unavailable