{ "openapi": "3.0.1", "info": { "title": "DC Business Registry - Entities, Trade Names, Beneficial Owners", "description": "Washington DC's business registry (public open data): 504K corporate registrations, 62K trade names and 491K beneficial owners, linked by file number so entity -> owners -> DBAs resolves on one id. Includes registered-agent details and the beneficial ownership layer DC publishes.", "version": "0.0", "x-build-id": "HePw6537KxlShgNHj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/j0401~dc-business-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-j0401-dc-business-registry", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/j0401~dc-business-registry/runs": { "post": { "operationId": "runs-sync-j0401-dc-business-registry", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/j0401~dc-business-registry/run-sync": { "post": { "operationId": "run-sync-j0401-dc-business-registry", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "", "corporate", "tradeName", "beneficial", "entity", "aggregate" ], "type": "string", "description": "corporate = registered entities (default). tradeName = registered trade names / DBAs. beneficial = the beneficial owners behind an entity. entity = EVERYTHING for one file number, in one response. aggregate = one count row per group.", "default": "corporate" }, "corpus": { "title": "Aggregate layer", "enum": [ "", "corporate", "tradeName", "beneficial" ], "type": "string", "description": "Which layer to aggregate - only used when mode=aggregate. Ignored otherwise.", "default": "corporate" }, "groupBy": { "title": "Group by", "type": "string", "description": "Aggregate dimension, only used when mode=aggregate. Valid per layer: corporate -> entityStatus, locale, modelType, state; tradeName -> tradeNameStatus; beneficial -> entityStatus, modelType, locale. Blank = a sensible default per layer. Blank = a sensible default for the selected table - do not leave it set when switching corpus.", "default": "" }, "fileNumber": { "title": "File number", "type": "string", "description": "Exact registry file number, e.g. 'L00005029230' or 'C00005497923'. One number links the entity, its trade names and its beneficial owners - this is the through-key. Blank = any. Use it with mode=entity to pull one entity's whole record.", "default": "" }, "name": { "title": "Business name", "type": "string", "description": "Entity name substring (corporate layer only), e.g. 'LLC'. Blank = any.", "default": "" }, "entityStatus": { "title": "Entity status", "enum": [ "", "Revoked", "Active - In Good Standing", "Dissolved", "Withdrawn", "Merged", "Inactive - Cancelled", "Terminated", "Domesticated", "Converted", "Consolidated", "Active - Not in Good Standing", "Active - In Good Standing - Pending Domestication" ], "type": "string", "description": "Exact entity status (corporate / beneficial layers). Blank = any.", "default": "" }, "locale": { "title": "Locale", "enum": [ "", "Domestic", "Foreign" ], "type": "string", "description": "Domestic = DC-formed; Foreign = out-of-state. Blank = any.", "default": "" }, "modelType": { "title": "Entity type", "enum": [ "", "Domestic Limited Liability Company", "Domestic Business Corporation", "Foreign Business Corporation", "Domestic Nonprofit Corporation", "Foreign Limited Liability Company", "Foreign Nonprofit Corporation", "Domestic Limited Partnership", "Foreign Limited Partnership", "Domestic Limited Liability Partnership", "Domestic General Cooperative Association", "Foreign Limited Liability Partnership", "Domestic Statutory Trust", "Foreign General Cooperative Association", "Domestic Act of Congress Corporation", "Domestic Limited Cooperative Association", "Foreign Statutory Trust", "Foreign Act of Congress Corporation", "Foreign Limited Cooperative Association" ], "type": "string", "description": "Exact entity type (corporate / beneficial layers). Blank = any.", "default": "" }, "tradeNameStatus": { "title": "Trade name status", "enum": [ "", "Inactive - Cancelled", "Expired", "Active Trade Name", "Cancelled", "Transferred", "Revoked", "Active - Not in Good Standing", "Active - Pending Expiration", "Active - In Good Standing" ], "type": "string", "description": "Exact trade-name status (tradeName layer only). Blank = any.", "default": "" }, "tradeName": { "title": "Trade name", "type": "string", "description": "Trade-name substring (tradeName layer only). Blank = any.", "default": "" }, "ownerName": { "title": "Owner name", "type": "string", "description": "Beneficial-owner name substring (beneficial layer only). Blank = any.", "default": "" }, "businessName": { "title": "Business name (owners)", "type": "string", "description": "Entity-name substring on the beneficial-owners layer. Blank = any.", "default": "" }, "effectiveFrom": { "title": "Trade name effective from", "type": "string", "description": "Earliest trade-name effective date, YYYY-MM-DD (tradeName layer only). Blank = any.", "default": "" }, "effectiveTo": { "title": "Trade name effective to", "type": "string", "description": "Latest trade-name effective date, YYYY-MM-DD (tradeName layer only). Blank = any.", "default": "" }, "maxResults": { "title": "Max records", "minimum": 0, "type": "integer", "description": "Cap records returned for this run. Default 50 keeps the daily auto-test fast. 0 = no cap (the full matching slice, up to 10,000).", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }