{ "openapi": "3.1.0", "info": { "title": "LLCDrop API", "version": "1", "description": "A read-only JSON API for Florida business filings: search businesses, look one up by id or state document number, list officers, and read daily filing counts, county and statewide stats." }, "externalDocs": { "description": "Human docs", "url": "https://llcdrop.com/developers" }, "servers": [ { "url": "https://api.llcdrop.com" } ], "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "Account" }, { "name": "Businesses" }, { "name": "Filings" }, { "name": "Counties and stats" }, { "name": "Reference lists" } ], "paths": { "/v1/me": { "get": { "operationId": "me", "summary": "Shows which key you are calling with: its scopes, its request caps and how many requests are left in each window. A good first call to check a new key.", "tags": [ "Account" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "object", "properties": { "perMinute": { "type": "integer" }, "perDay": { "type": "integer" }, "perMonth": { "type": "integer" } }, "required": [ "perMinute", "perDay", "perMonth" ] }, "remaining": { "type": "object", "properties": { "minute": { "type": "integer" }, "day": { "type": "integer" }, "month": { "type": "integer" } }, "required": [ "minute", "day", "month" ] } }, "required": [ "kind", "id", "scopes", "limits", "remaining" ] }, "example": { "kind": "client", "id": "example-key-id", "scopes": [ "data" ], "limits": { "perMinute": 20, "perDay": 1000, "perMonth": 10000 }, "remaining": { "minute": 19, "day": 999, "month": 9999 } } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/businesses": { "get": { "operationId": "businessesList", "summary": "Search Florida business filings by name prefix, or list filings in a date range. Newest filings first. Every call needs a narrowing filter.", "description": "Send q, city, zip or a filed_from date. County, type, industry and status never narrow a search on their own. With q, filed_from and filed_to are free: search any period. Without q, filed_from is required, must not be older than your plan's daily window (403 otherwise), and the range from filed_from to filed_to (today in Eastern time when omitted) spans at most 92 days. Name search matches the start of the name only. There is no contains or fuzzy match. Fictitious name filings are listed with type=fictitious.", "tags": [ "Businesses" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Start of the business name, 2 to 80 characters. Lets filed_from and filed_to be free.", "schema": { "type": "string" } }, { "name": "city", "in": "query", "required": false, "description": "City name, up to 40 characters. Narrows the search on its own.", "schema": { "type": "string" } }, { "name": "zip", "in": "query", "required": false, "description": "A 5-digit ZIP code, or a prefix of 3 to 4 digits. Narrows the search on its own.", "schema": { "type": "string" } }, { "name": "county", "in": "query", "required": false, "description": "Florida county name, up to 40 characters, for example Broward. Does not narrow a search on its own.", "schema": { "type": "string" } }, { "name": "filed_from", "in": "query", "required": false, "description": "First filing date, YYYY-MM-DD. Required when there is no q, city or zip and you search by date.", "schema": { "type": "string", "format": "date" } }, { "name": "filed_to", "in": "query", "required": false, "description": "Last filing date, YYYY-MM-DD. Defaults to today in Eastern time. Needs filed_from when there is no q.", "schema": { "type": "string", "format": "date" } }, { "name": "type", "in": "query", "required": false, "description": "One of llc, corporation, partnership, nonprofit, fictitious, trust. The values are listed by GET /v1/fl/entity-types.", "schema": { "type": "string" } }, { "name": "industry", "in": "query", "required": false, "description": "A key from GET /v1/fl/industries: a sector, a sector.type key or a named segment.", "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "description": "active (default) or all. all includes dissolved businesses and needs a q of 2 or more characters.", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows to return, 1 to 1,000. Default 25. A value above your plan's rows per call is reduced to it, and the response reports the limit applied.", "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "description": "Rows to skip, 0 to 100,000. Default 0. A value above your plan's max offset is a 400.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "document_number": { "type": "string" }, "name": { "type": "string" }, "entity_type": { "type": "string" }, "company_type": { "type": "string" }, "status": { "type": "string" }, "filed_date": { "type": "string" }, "dissolved_date": { "type": "null" }, "city": { "type": "string" }, "zip": { "type": "string" }, "county": { "type": "string" }, "industry": { "type": "object", "properties": { "sector": { "type": "string" }, "type": { "type": "string" } }, "required": [ "sector", "type" ] }, "url": { "type": "string" } }, "required": [ "id", "document_number", "name", "entity_type", "company_type", "status", "filed_date", "dissolved_date", "city", "zip", "county", "industry", "url" ] } }, "pagination": { "type": "object", "properties": { "limit": { "type": "integer" }, "offset": { "type": "integer" }, "has_more": { "type": "boolean" }, "total": { "type": "integer" } }, "required": [ "limit", "offset", "has_more", "total" ] } }, "required": [ "data", "pagination" ] }, "example": { "data": [ { "id": "1234567", "document_number": "L00000000000", "name": "Example Holdings LLC", "entity_type": "llc", "company_type": "LLC", "status": "active", "filed_date": "2026-10-09", "dissolved_date": null, "city": "Miami", "zip": "33101", "county": "Miami-Dade", "industry": { "sector": "construction", "type": "construction.general_contractor" }, "url": "https://llcdrop.com/business/1234567" } ], "pagination": { "limit": 25, "offset": 0, "has_more": true, "total": 1234 } } } } }, "400": { "description": "Invalid query: an unknown parameter, a value out of bounds, no narrowing filter, an offset above your plan's max offset, or a filed range over 92 days without q.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 400, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The plan or scope does not allow API access, or filed_from is older than your plan's daily window.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/businesses/by-document/{document_number}": { "get": { "operationId": "businessByDocument", "summary": "One business by its state document number. Case does not matter. Returns the same fields as the lookup by id.", "tags": [ "Businesses" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "document_number", "in": "path", "required": true, "description": "The state document number, 6 to 12 letters or digits.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "document_number": { "type": "string" }, "name": { "type": "string" }, "entity_type": { "type": "string" }, "company_type": { "type": "string" }, "status": { "type": "string" }, "filed_date": { "type": "string" }, "dissolved_date": { "type": "null" }, "city": { "type": "string" }, "zip": { "type": "string" }, "county": { "type": "string" }, "industry": { "type": "object", "properties": { "sector": { "type": "string" }, "type": { "type": "string" } }, "required": [ "sector", "type" ] }, "url": { "type": "string" }, "principal_address": { "type": "object", "properties": { "street": { "type": "string" }, "street2": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "zip": { "type": "string" }, "country": { "type": "string" } }, "required": [ "street", "street2", "city", "state", "zip", "country" ] }, "mailing_address": { "type": "null" }, "registered_agent_name": { "type": "string" }, "formation_state": { "type": "string" }, "last_annual_report_year": { "type": "integer" }, "officer_count": { "type": "integer" }, "license_count": { "type": "integer" } }, "required": [ "id", "document_number", "name", "entity_type", "company_type", "status", "filed_date", "dissolved_date", "city", "zip", "county", "industry", "url", "principal_address", "mailing_address", "registered_agent_name", "formation_state", "last_annual_report_year", "officer_count", "license_count" ] } }, "required": [ "data" ] }, "example": { "data": { "id": "1234567", "document_number": "L00000000000", "name": "Example Holdings LLC", "entity_type": "llc", "company_type": "LLC", "status": "active", "filed_date": "2026-10-09", "dissolved_date": null, "city": "Miami", "zip": "33101", "county": "Miami-Dade", "industry": { "sector": "construction", "type": "construction.general_contractor" }, "url": "https://llcdrop.com/business/1234567", "principal_address": { "street": "100 Example Street", "street2": "Suite 1", "city": "Miami", "state": "FL", "zip": "33101", "country": "US" }, "mailing_address": null, "registered_agent_name": "Example Registered Agent Inc.", "formation_state": "FL", "last_annual_report_year": 2026, "officer_count": 2, "license_count": 0 } } } } }, "400": { "description": "document_number is not 6 to 12 letters or digits.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 400, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "404": { "description": "No business has that document number.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 404, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/businesses/{id}": { "get": { "operationId": "businessById", "summary": "One business by its LLCDrop id, with addresses, the registered agent's name, formation state, last annual report year and officer and license counts.", "tags": [ "Businesses" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "The id returned by the list endpoints, a positive integer.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "document_number": { "type": "string" }, "name": { "type": "string" }, "entity_type": { "type": "string" }, "company_type": { "type": "string" }, "status": { "type": "string" }, "filed_date": { "type": "string" }, "dissolved_date": { "type": "null" }, "city": { "type": "string" }, "zip": { "type": "string" }, "county": { "type": "string" }, "industry": { "type": "object", "properties": { "sector": { "type": "string" }, "type": { "type": "string" } }, "required": [ "sector", "type" ] }, "url": { "type": "string" }, "principal_address": { "type": "object", "properties": { "street": { "type": "string" }, "street2": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "zip": { "type": "string" }, "country": { "type": "string" } }, "required": [ "street", "street2", "city", "state", "zip", "country" ] }, "mailing_address": { "type": "null" }, "registered_agent_name": { "type": "string" }, "formation_state": { "type": "string" }, "last_annual_report_year": { "type": "integer" }, "officer_count": { "type": "integer" }, "license_count": { "type": "integer" } }, "required": [ "id", "document_number", "name", "entity_type", "company_type", "status", "filed_date", "dissolved_date", "city", "zip", "county", "industry", "url", "principal_address", "mailing_address", "registered_agent_name", "formation_state", "last_annual_report_year", "officer_count", "license_count" ] } }, "required": [ "data" ] }, "example": { "data": { "id": "1234567", "document_number": "L00000000000", "name": "Example Holdings LLC", "entity_type": "llc", "company_type": "LLC", "status": "active", "filed_date": "2026-10-09", "dissolved_date": null, "city": "Miami", "zip": "33101", "county": "Miami-Dade", "industry": { "sector": "construction", "type": "construction.general_contractor" }, "url": "https://llcdrop.com/business/1234567", "principal_address": { "street": "100 Example Street", "street2": "Suite 1", "city": "Miami", "state": "FL", "zip": "33101", "country": "US" }, "mailing_address": null, "registered_agent_name": "Example Registered Agent Inc.", "formation_state": "FL", "last_annual_report_year": 2026, "officer_count": 2, "license_count": 0 } } } } }, "400": { "description": "id is not a positive integer.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 400, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "404": { "description": "No business has that id.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 404, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/businesses/{id}/officers": { "get": { "operationId": "businessOfficers", "summary": "Names and titles of a business's officers, sorted by name, at most 25. No contact details.", "tags": [ "Businesses" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "The id returned by the list endpoints, a positive integer.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "title": { "type": "string" } }, "required": [ "name", "title" ] } } }, "required": [ "data" ] }, "example": { "data": [ { "name": "Jane Example", "title": "Manager" } ] } } } }, "400": { "description": "id is not a positive integer.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 400, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "404": { "description": "No business has that id.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 404, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/filings/daily": { "get": { "operationId": "dailyIndex", "summary": "How many businesses filed on each recent day, counting back from today in Eastern time.", "description": "days is also capped by your plan's daily window, so a larger value returns fewer days, not an error. The pagination block is always a single page.", "tags": [ "Filings" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "days", "in": "query", "required": false, "description": "Days to count back, today included, 1 to 90. Default 30.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "count": { "type": "integer" } }, "required": [ "date", "count" ] } }, "pagination": { "type": "object", "properties": { "limit": { "type": "integer" }, "offset": { "type": "integer" }, "has_more": { "type": "boolean" }, "total": { "type": "integer" } }, "required": [ "limit", "offset", "has_more", "total" ] } }, "required": [ "data", "pagination" ] }, "example": { "data": [ { "date": "2026-10-10", "count": 412 }, { "date": "2026-10-09", "count": 398 } ], "pagination": { "limit": 2, "offset": 0, "has_more": false, "total": 2 } } } } }, "400": { "description": "days is not a whole number in range.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 400, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/filings/daily/{date}": { "get": { "operationId": "dailyFilings", "summary": "The businesses that filed on one day, newest first, paginated.", "description": "The date must fall inside your plan's daily window and cannot be in the future.", "tags": [ "Filings" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "date", "in": "path", "required": true, "description": "The filing day, YYYY-MM-DD.", "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows to return, 1 to 1,000. Default 25. A value above your plan's rows per call is reduced to it, and the response reports the limit applied.", "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "description": "Rows to skip, 0 to 100,000. Default 0. A value above your plan's max offset is a 400.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "document_number": { "type": "string" }, "name": { "type": "string" }, "entity_type": { "type": "string" }, "company_type": { "type": "string" }, "status": { "type": "string" }, "filed_date": { "type": "string" }, "dissolved_date": { "type": "null" }, "city": { "type": "string" }, "zip": { "type": "string" }, "county": { "type": "string" }, "industry": { "type": "object", "properties": { "sector": { "type": "string" }, "type": { "type": "string" } }, "required": [ "sector", "type" ] }, "url": { "type": "string" } }, "required": [ "id", "document_number", "name", "entity_type", "company_type", "status", "filed_date", "dissolved_date", "city", "zip", "county", "industry", "url" ] } }, "pagination": { "type": "object", "properties": { "limit": { "type": "integer" }, "offset": { "type": "integer" }, "has_more": { "type": "boolean" }, "total": { "type": "integer" } }, "required": [ "limit", "offset", "has_more", "total" ] } }, "required": [ "data", "pagination" ] }, "example": { "data": [ { "id": "1234567", "document_number": "L00000000000", "name": "Example Holdings LLC", "entity_type": "llc", "company_type": "LLC", "status": "active", "filed_date": "2026-10-09", "dissolved_date": null, "city": "Miami", "zip": "33101", "county": "Miami-Dade", "industry": { "sector": "construction", "type": "construction.general_contractor" }, "url": "https://llcdrop.com/business/1234567" } ], "pagination": { "limit": 25, "offset": 0, "has_more": true, "total": 412 } } } } }, "400": { "description": "date is not a real YYYY-MM-DD day or is in the future, or limit or offset is out of bounds.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 400, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The plan or scope does not allow API access, or the date is older than your plan's daily window.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/counties": { "get": { "operationId": "counties", "summary": "New-filing counts for every Florida county. Not paginated.", "tags": [ "Counties and stats" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" }, "filings_last_7_days": { "type": "integer" }, "filings_last_30_days": { "type": "integer" }, "filings_previous_30_days": { "type": "integer" }, "active_businesses": { "type": "integer" } }, "required": [ "key", "name", "filings_last_7_days", "filings_last_30_days", "filings_previous_30_days", "active_businesses" ] } } }, "required": [ "data" ] }, "example": { "data": [ { "key": "BROWARD", "name": "Broward", "filings_last_7_days": 10, "filings_last_30_days": 40, "filings_previous_30_days": 35, "active_businesses": 900 } ] } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/counties/{key}": { "get": { "operationId": "county", "summary": "New-filing counts for one county. There is no per-county filings list; use the businesses search with county.", "tags": [ "Counties and stats" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "key", "in": "path", "required": true, "description": "A county key from GET /v1/fl/counties, for example BROWARD. Case does not matter.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" }, "filings_last_7_days": { "type": "integer" }, "filings_last_30_days": { "type": "integer" }, "filings_previous_30_days": { "type": "integer" }, "active_businesses": { "type": "integer" } }, "required": [ "key", "name", "filings_last_7_days", "filings_last_30_days", "filings_previous_30_days", "active_businesses" ] } }, "required": [ "data" ] }, "example": { "data": { "key": "BROWARD", "name": "Broward", "filings_last_7_days": 10, "filings_last_30_days": 40, "filings_previous_30_days": 35, "active_businesses": 900 } } } } }, "400": { "description": "key is not a valid county key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 400, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "404": { "description": "Unknown county.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 404, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/stats": { "get": { "operationId": "stats", "summary": "Totals, filings over recent periods, a monthly series and the split by business type for the last 30 days. Timestamps are ISO 8601 in UTC.", "description": "The monthly series may include the current month, marked partial.", "tags": [ "Counties and stats" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "businesses_total": { "type": "integer" }, "latest_filing_date": { "type": "string" }, "updated_at": { "type": "string" }, "filings": { "type": "object", "properties": { "last_7_days": { "type": "integer" }, "last_30_days": { "type": "integer" }, "previous_30_days": { "type": "integer" }, "last_365_days": { "type": "integer" } }, "required": [ "last_7_days", "last_30_days", "previous_30_days", "last_365_days" ] }, "monthly": { "type": "array", "items": { "type": "object", "properties": { "month": { "type": "string" }, "total": { "type": "integer" }, "partial": { "type": "boolean" }, "by_type": { "type": "object", "properties": { "llc": { "type": "integer" }, "corporation": { "type": "integer" }, "partnership": { "type": "integer" }, "nonprofit": { "type": "integer" }, "trust": { "type": "integer" }, "fictitious": { "type": "integer" }, "other": { "type": "integer" } }, "required": [ "llc", "corporation", "partnership", "nonprofit", "trust", "fictitious", "other" ] } }, "required": [ "month", "total", "partial", "by_type" ] } }, "type_split_30d": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "n": { "type": "integer" } }, "required": [ "type", "n" ] } } }, "required": [ "businesses_total", "latest_filing_date", "updated_at", "filings", "monthly", "type_split_30d" ] } }, "required": [ "data" ] }, "example": { "data": { "businesses_total": 1000000, "latest_filing_date": "2026-10-10", "updated_at": "2026-10-11T06:00:00.000Z", "filings": { "last_7_days": 2800, "last_30_days": 12000, "previous_30_days": 11500, "last_365_days": 140000 }, "monthly": [ { "month": "2026-09", "total": 11800, "partial": false, "by_type": { "llc": 8000, "corporation": 1500, "partnership": 100, "nonprofit": 200, "trust": 50, "fictitious": 1500, "other": 450 } } ], "type_split_30d": [ { "type": "llc", "n": 8100 } ] } } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/industries": { "get": { "operationId": "industries", "summary": "The values the industry filter accepts: sectors with their types, and named segments. Not paginated. Lists are shortened in this example.", "description": "A key that is both a sector and a segment, such as retail, means the sector.", "tags": [ "Reference lists" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "sectors": { "type": "array", "items": { "type": "object", "properties": { "sector": { "type": "string" }, "types": { "type": "array", "items": { "type": "string" } } }, "required": [ "sector", "types" ] } }, "segments": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "sectors": { "type": "array", "items": { "type": "string" } }, "types": { "type": "array" } }, "required": [ "key", "sectors", "types" ] } } }, "required": [ "sectors", "segments" ] } }, "required": [ "data" ] }, "example": { "data": { "sectors": [ { "sector": "construction", "types": [ "construction.general_contractor", "construction.roofing" ] } ], "segments": [ { "key": "trades", "sectors": [ "construction" ], "types": [] } ] } } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } }, "/v1/fl/entity-types": { "get": { "operationId": "entityTypes", "summary": "The values the type filter accepts, with a plain label for each. Not paginated.", "tags": [ "Reference lists" ], "security": [ { "bearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "label" ] } } }, "required": [ "data" ] }, "example": { "data": [ { "key": "llc", "label": "Limited liability company" }, { "key": "corporation", "label": "Corporation" }, { "key": "partnership", "label": "Partnership" }, { "key": "nonprofit", "label": "Nonprofit" }, { "key": "fictitious", "label": "Fictitious name" }, { "key": "trust", "label": "Trust" } ] } } } }, "401": { "description": "Missing or invalid key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 401, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "403": { "description": "The account's plan does not include API access, or the key lacks the data scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 403, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "429": { "description": "Over a limit for your account. Wait the number of seconds in the Retry-After header.", "headers": { "Retry-After": { "description": "Seconds to wait before calling again.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 429, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } }, "503": { "description": "Key check or data temporarily unavailable. Try again shortly.", "content": { "application/json": { "schema": { "type": "object", "properties": { "statusCode": { "type": "integer" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "docs_url": { "type": "string", "format": "uri", "description": "Link to the full reference as Markdown." } }, "required": [ "statusCode", "message" ] }, "example": { "statusCode": 503, "message": "Rate limit exceeded (minute limit)", "docs_url": "https://api.llcdrop.com/docs.md" } } } } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "An LLCDrop API key with the data scope, sent as Authorization: Bearer ." } } } }