{
  "openapi": "3.0.1",
  "info": {
    "title": "NY Corporation Registry - Companies & Filing History",
    "description": "New York's corporation register (4.28M companies) and its complete Department of State filing history (20.9M documents): entity type, county, CEO, registered agent and address, plus every filed document, the status trail, the name trail and every address of record - joined on the exact DOS id.",
    "version": "0.0",
    "x-build-id": "Gx7fsT2b15i2NSoT9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/j0401~ny-corporation-registry/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-j0401-ny-corporation-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~ny-corporation-registry/runs": {
      "post": {
        "operationId": "runs-sync-j0401-ny-corporation-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~ny-corporation-registry/run-sync": {
      "post": {
        "operationId": "run-sync-j0401-ny-corporation-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": [
              "rows",
              "aggregate",
              "profile"
            ],
            "type": "string",
            "description": "rows = records matching your filters (default). aggregate = one count row per group (see groupBy). profile = one corporation's register row plus its entire filing history - requires entityId.",
            "default": "rows"
          },
          "corpus": {
            "title": "Corpus",
            "enum": [
              "entities",
              "filings",
              "statuses",
              "names",
              "addresses"
            ],
            "type": "string",
            "description": "entities = the register (4,280,630 corporations, default). filings = filed documents (20,946,484). statuses = the same filings carrying the corporation's status at that time (20,946,484) - where Active / Inactive / Suspended / Discontinued lives. names = recorded names, in use or superseded (7,493,463). addresses = addresses of record on each filing (18,395,004). Filters below apply to the corpus you pick.",
            "default": "entities"
          },
          "entityId": {
            "title": "DOS ID",
            "type": "string",
            "description": "Exact New York DOS id (numeric), e.g. '1000013'. The one key that ties a corporation to its whole history. Also the mode=profile input. Entity records carry lastStatus / lastStatusDate (newest stated standing) and lastFilingDate (newest filing of any kind).",
            "default": ""
          },
          "name": {
            "title": "Entity name",
            "type": "string",
            "description": "Entity name substring, e.g. 'CONTRACTING', 'TRUCKING'. Matches the current name on the register. (entities corpus)",
            "default": ""
          },
          "entityType": {
            "title": "Entity type",
            "enum": [
              "",
              "ASSUMED NAME",
              "DOMESTIC BENEFIT CORPORATION",
              "DOMESTIC BENEVOLENT ORDER",
              "DOMESTIC BUSINESS CORPORATION",
              "DOMESTIC CONDOMINIUM",
              "DOMESTIC CONDOMINIUM DECLARATION",
              "DOMESTIC COOPERATIVE CORPORATION",
              "DOMESTIC COOPERATIVE CORPORATION (WORKER COOPERATIVE)",
              "DOMESTIC DESIGN PROFESSIONAL SERVICE CORPORATION",
              "DOMESTIC DESIGNATION OF THE SECRETARY OF STATE",
              "DOMESTIC EDUCATION CORPORATION (REFER TO THE NYS EDUCATION DEPARTMENT)",
              "DOMESTIC GENERAL ASSOCIATION",
              "DOMESTIC GOVERNMENTAL AGENCY",
              "DOMESTIC HOUSING DEVELOPMENT FUND COMPANY (ARTICLE XI)",
              "DOMESTIC INSURANCE COMPANY (REFER TO INSURANCE DEPARTMENT)",
              "DOMESTIC JOINT STOCK ASSOCIATION",
              "DOMESTIC LIMITED LIABILITY COMPANY",
              "DOMESTIC LIMITED PARTNERSHIP",
              "DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & BCL)",
              "DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & NPCL)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (BOARD OF TRADE AND CHAMBER OF COMMERCE CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (COMMUNITY MENTAL HEALTH SERVICES AND MENTAL RETARDATION SERVICES COMPANIES)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (FIRE CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (HOUSING DEVELOPMENT FUND COMPANY) (ARTICLE XI)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (LAND BANK)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (LOCAL DEVELOPMENT CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (MILITIA ASSOCIATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (PUBLIC CEMETERY CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (UNIVERSITY FACULTY PRACTICE CORPORATION)",
              "DOMESTIC PROFESSIONAL SERVICE CORPORATION",
              "DOMESTIC PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY",
              "DOMESTIC PUBLIC BENEFIT CORPORATION",
              "DOMESTIC RAILROAD CORPORATION",
              "DOMESTIC REDEVELOPMENT COMPANY (ARTICLE V)",
              "DOMESTIC REDEVELOPMENT COMPANY (LIMITED LIABILITY COMPANY)",
              "DOMESTIC REDEVELOPMENT COMPANY (LIMITED PARTNERSHIP)",
              "DOMESTIC REGISTERED LIMITED LIABILITY PARTNERSHIP",
              "DOMESTIC RELIGIOUS CORPORATION",
              "DOMESTIC RELIGIOUS CORPORATION (GOVERNING OR ADVISORY BODY)",
              "DOMESTIC RELIGIOUS CORPORATION (REFER TO COUNTY CLERK)",
              "DOMESTIC RELIGIOUS CORPORATION - REFER TO COUNTY CLERK",
              "DOMESTIC TRANSPORTATION CORPORATION",
              "FOREIGN BUSINESS CORPORATION",
              "FOREIGN BUSINESS CORPORATION WITH A FICTITIOUS NAME",
              "FOREIGN COOPERATIVE CORPORATION",
              "FOREIGN DESIGNATION OF THE SECRETARY OF STATE",
              "FOREIGN GENERAL ASSOCIATION",
              "FOREIGN LIMITED LIABILITY COMPANY",
              "FOREIGN LIMITED LIABILITY COMPANY WITH A FICTITIOUS NAME",
              "FOREIGN LIMITED PARTNERSHIP",
              "FOREIGN LIMITED PARTNERSHIP WITH A FICTITIOUS NAME",
              "FOREIGN NOT-FOR-PROFIT CORPORATION",
              "FOREIGN NOT-FOR-PROFIT CORPORATION WITH A FICTITIOUS NAME",
              "FOREIGN PROFESSIONAL SERVICE CORPORATION",
              "FOREIGN PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY",
              "FOREIGN RELIGIOUS CORPORATION",
              "GENERAL ASSOCIATION DESIGNATION",
              "NEW YORK REGISTERED FOREIGN LIMITED LIABILITY PARTNERSHIP",
              "NON-DOS ID",
              "NON-DOS_ASSUMED_NAME",
              "OTHER",
              "RESERVATION OF DOMESTIC BUSINESS CORPORATION",
              "RESERVATION OF DOMESTIC LIMITED LIABILITY COMPANY",
              "RESERVATION OF DOMESTIC LIMITED PARTNERSHIP",
              "RESERVATION OF DOMESTIC NOT FOR PROFIT CORPORATION",
              "RESERVATION OF FOREIGN BUSINESSCORPORATION",
              "RESERVATION OF FOREIGN LIMITED LIABILITY COMPANY",
              "RESERVATION OF FOREIGN LIMITED PARTNERSHIP",
              "RESERVATION OF FOREIGN NOT FOR PROFIT CORPORATION",
              "UNAUTHORIZED BUSINESS CORPORATION",
              "UNAUTHORIZED EDUCATION CORPORATION",
              "UNAUTHORIZED ENTITY TYPE",
              "UNAUTHORIZED FOREIGN BUSINESS CORPORATION",
              "UNAUTHORIZED FOREIGN COOPERATIVE CORPORATION",
              "UNAUTHORIZED FOREIGN LIMITED LIABILITY COMPANY",
              "UNAUTHORIZED FOREIGN LIMITED PARTNERSHIP",
              "UNAUTHORIZED FOREIGN NOT-FOR-PROFIT CORPORATION",
              "UNAUTHORIZED FOREIGN PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY",
              "UNAUTHORIZED LIMITED LIABILITY COMPANY",
              "UNAUTHORIZED LIMITED PARTNERSHIP",
              "UNAUTHORIZED NOT-FOR-PROFIT CORPORATION",
              "UNAUTHORIZED PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY",
              "UNAUTHORIZED RELIGIOUS CORPORATION"
            ],
            "type": "string",
            "description": "Exact New York entity type - all 84 values the source publishes, across both corpora (54 appear on the register, 84 on filings; 30 exist only as filing types). Domestic limited liability company 2.05M, domestic business corporation 1.45M. Blank = any. (both corpora)",
            "default": ""
          },
          "county": {
            "title": "County",
            "type": "string",
            "description": "County substring, e.g. 'New York' (830,064), 'Kings', 'Queens'. Blank = any. (both corpora)",
            "default": ""
          },
          "jurisdiction": {
            "title": "Jurisdiction",
            "type": "string",
            "description": "Jurisdiction of formation, e.g. 'New York' (3.93M), 'Delaware' (197,574). Substring match. Blank = any. (entities corpus)",
            "default": ""
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "City substring - matches the DOS process address, the principal location or the CEO address. Blank = any. (entities corpus)",
            "default": ""
          },
          "zip": {
            "title": "ZIP",
            "type": "string",
            "description": "ZIP - matches the 5-digit prefix on the DOS process, location, CEO or registered-agent address, so both '10550' and the ZIP+4 form the source stores ('105503001') are returned. Digits and dashes only. Blank = any. (entities corpus)",
            "default": ""
          },
          "agentName": {
            "title": "Registered agent",
            "type": "string",
            "description": "Registered-agent name substring. Blank = any. (entities corpus)",
            "default": ""
          },
          "documentType": {
            "title": "Document type",
            "type": "string",
            "description": "Filing document type substring, e.g. 'BIENNIAL STATEMENT' (7.09M), 'CERTIFICATE OF INCORPORATION' (4.07M), 'ARTICLES OF ORGANIZATION' (2.35M), 'DISSOLUTION'. Blank = any. (filings corpus)",
            "default": ""
          },
          "filingName": {
            "title": "Name on filing",
            "type": "string",
            "description": "The corporation name as recorded on the filing - for a name-change filing this is the name at that time. Blank = any. (filings corpus)",
            "default": ""
          },
          "law": {
            "title": "Law",
            "type": "string",
            "description": "The law the document was filed under, substring match, e.g. 'LIMITED LIABILITY COMPANY LAW'. Blank = any. (filings corpus)",
            "default": ""
          },
          "filingNum": {
            "title": "Filing number",
            "type": "string",
            "description": "Exact filing (film) number, e.g. '210621000105'. Blank = any. (filings corpus)",
            "default": ""
          },
          "filedFrom": {
            "title": "Filed on or after",
            "type": "string",
            "description": "Filings with a date on or after this (YYYY-MM-DD). Rows with no date are kept, not dropped. Blank = any. (both corpora)",
            "default": ""
          },
          "filedTo": {
            "title": "Filed on or before",
            "type": "string",
            "description": "Filings with a date on or before this (YYYY-MM-DD). Blank = any. (both corpora)",
            "default": ""
          },
          "effectiveFrom": {
            "title": "Effective on or after",
            "type": "string",
            "description": "Filings taking effect on or after this date (YYYY-MM-DD). Blank = any. (filings corpus)",
            "default": ""
          },
          "effectiveTo": {
            "title": "Effective on or before",
            "type": "string",
            "description": "Filings taking effect on or before this date (YYYY-MM-DD). Blank = any. (filings corpus)",
            "default": ""
          },
          "groupBy": {
            "title": "Aggregate by",
            "enum": [
              "",
              "entityType",
              "county",
              "jurisdiction",
              "documentType",
              "law",
              "status",
              "nameStatus",
              "addressType"
            ],
            "type": "string",
            "description": "Which dimension to aggregate over (mode=aggregate). entityType / county / jurisdiction belong to entities; documentType and law to filings; status to statuses; nameStatus to names; addressType to addresses. Blank = a sensible default for the selected table - do not leave it set when switching corpus.",
            "default": ""
          },
          "maxResults": {
            "title": "Max records",
            "minimum": 0,
            "type": "integer",
            "description": "Cap the number of records pushed in rows / profile mode (0 = up to ~10k per run; each record is metered individually, so there is no per-run charge cap). Aggregate mode returns every group.",
            "default": 50
          },
          "status": {
            "title": "Corporation status",
            "enum": [
              "",
              "Active",
              "Inactive",
              "Suspended",
              "Discontinued"
            ],
            "type": "string",
            "description": "Exact corporation status as recorded on the filing: Active, Inactive, Suspended, Discontinued. Blank = any. (statuses corpus)",
            "default": ""
          },
          "nameStatus": {
            "title": "Name status",
            "enum": [
              "",
              "A",
              "I"
            ],
            "type": "string",
            "description": "Whether the name on that filing was in use ('A') or superseded ('I'). Blank = any. (names corpus)",
            "default": ""
          },
          "addressType": {
            "title": "Address type",
            "type": "string",
            "description": "Numeric address-type code the source assigns (1, 2, 3, 4, ...). Blank = any. (addresses corpus)",
            "default": ""
          },
          "addressName": {
            "title": "Party on the address",
            "type": "string",
            "description": "Name of the party the address belonged to, substring match. Blank = any. (addresses corpus)",
            "default": ""
          },
          "addressCity": {
            "title": "Address city",
            "type": "string",
            "description": "City substring on the address of record. Blank = any. (addresses corpus)",
            "default": ""
          },
          "addressState": {
            "title": "Address state",
            "type": "string",
            "description": "Two-letter state on the address of record. Blank = any. (addresses corpus)",
            "default": ""
          },
          "addressZip": {
            "title": "Address ZIP",
            "type": "string",
            "description": "ZIP on the address of record - matches the 5-digit part or the full ZIP+4. Blank = any. (addresses corpus)",
            "default": ""
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}