{
  "openapi": "3.0.1",
  "info": {
    "title": "Secretary of State Business Entity Search + SEC & UK — KYB",
    "description": "State business entity search for DE, NY, PA, CT, OR, CO, NJ, MN, AL, KY, ID, ND and AR, plus the Texas Comptroller franchise-taxpayer register, SEC EDGAR and UK Companies House. Search by name; UK also by company number, SIC code, location, type, status and dates. For KYB.",
    "version": "0.0",
    "x-build-id": "d5JyhlGe9xLI8vxI8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nexgendata~business-registration-lookup/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nexgendata-business-registration-lookup",
        "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/nexgendata~business-registration-lookup/runs": {
      "post": {
        "operationId": "runs-sync-nexgendata-business-registration-lookup",
        "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/nexgendata~business-registration-lookup/run-sync": {
      "post": {
        "operationId": "run-sync-nexgendata-business-registration-lookup",
        "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": {
          "companyName": {
            "title": "Company Name",
            "type": "string",
            "description": "Legal or trading name (or partial name) to search for. Examples: 'Acme Corporation', 'Stripe', 'Tesla'. Searched across SEC EDGAR, UK Companies House and the US state registers chosen in 'states'."
          },
          "companyNames": {
            "title": "Company names (list — one lookup per name)",
            "type": "array",
            "description": "Optional list of company names. Each name is looked up exactly like 'companyName' (same jurisdiction, 'maxResults' per name) and returns the same records, charged the same per record, as a run of its own. Leave empty to use the single field.",
            "items": {
              "type": "string"
            }
          },
          "jurisdiction": {
            "title": "Jurisdiction",
            "enum": [
              "all",
              "us",
              "uk"
            ],
            "type": "string",
            "description": "Which registries to search. 'all' = US + UK (recommended), 'us' = SEC EDGAR plus the state registers chosen in 'states', 'uk' = Companies House only (states are not searched).",
            "default": "all"
          },
          "states": {
            "title": "US states (state business registers)",
            "type": "array",
            "description": "Optional. US state business registers to search as well, by the same company name, when jurisdiction is 'all' or 'us': Delaware, New York, Pennsylvania, Connecticut, Oregon, Colorado, Minnesota, Alabama, Kentucky, Idaho, North Dakota and Arkansas (Secretary of State business entity records), New Jersey (Division of Revenue business name search) and Texas (the Comptroller's franchise-taxpayer register, not a Secretary of State register). Each state row carries that state's own fields plus 'state'. Rows from every source share maxResults, taken in turn. Leave empty to search SEC EDGAR and Companies House only.",
            "items": {
              "type": "string",
              "enum": [
                "DE",
                "NY",
                "PA",
                "CT",
                "OR",
                "TX",
                "CO",
                "NJ",
                "MN",
                "AL",
                "KY",
                "ID",
                "ND",
                "AR"
              ],
              "enumTitles": [
                "Delaware",
                "New York",
                "Pennsylvania",
                "Connecticut",
                "Oregon",
                "Texas (franchise-taxpayer register)",
                "Colorado",
                "New Jersey",
                "Minnesota",
                "Alabama",
                "Kentucky",
                "Idaho",
                "North Dakota",
                "Arkansas"
              ]
            }
          },
          "ukDetails": {
            "title": "UK company details (Companies House pages)",
            "type": "array",
            "description": "Optional. For each UK Companies House row, also read the company's public Companies House pages and add: officers (first page: name, role, status, appointed/resigned dates, month and year of birth, nationality, address), owners (persons with significant control and their nature of control, or the register's note when there are none), filing history (latest page: date, type, description, document link) and charges (title, dates, status, persons entitled). Same row, same single charge. Leave empty for the rows as before.",
            "items": {
              "type": "string",
              "enum": [
                "officers",
                "owners",
                "filings",
                "charges"
              ],
              "enumTitles": [
                "Officers",
                "Owners (persons with significant control)",
                "Filing history",
                "Charges"
              ]
            }
          },
          "ukCompanyNumbers": {
            "title": "UK company numbers (exact lookups)",
            "type": "array",
            "description": "Optional. UK company numbers to look up directly on Companies House (for example 00445790 or SC123456). Each number gives that company's record: name, status, company type, incorporation and dissolution dates, registered office address and SIC codes. Public Companies House pages; nothing to sign up for. companyName is not needed when this is set.",
            "items": {
              "type": "string"
            }
          },
          "ukSicCodes": {
            "title": "UK SIC codes",
            "type": "array",
            "description": "Optional. Search UK companies by nature of business (SIC code, for example 62020). Several codes run one search each and are merged. companyName, if set, narrows the search to names that include it.",
            "items": {
              "type": "string"
            }
          },
          "ukLocation": {
            "title": "UK registered office location",
            "type": "string",
            "description": "Optional. Town, city or postcode in the registered office address (for example Leeds or LS1)."
          },
          "ukCompanyType": {
            "title": "UK company type",
            "type": "array",
            "description": "Optional. Company types to include (Companies House's own list).",
            "items": {
              "type": "string",
              "enum": [
                "ltd",
                "plc",
                "llp",
                "limited-partnership",
                "private-unlimited",
                "private-unlimited-nsc",
                "private-limited-guarant-nsc",
                "private-limited-guarant-nsc-limited-exemption",
                "private-limited-shares-section-30-exemption",
                "oversea-company",
                "registered-overseas-entity",
                "uk-establishment",
                "charitable-incorporated-organisation",
                "scottish-charitable-incorporated-organisation",
                "scottish-partnership",
                "industrial-and-provident-society",
                "registered-society-non-jurisdictional",
                "royal-charter",
                "icvc",
                "protected-cell-company",
                "eeig",
                "european-public-limited-liability-company-se",
                "further-education-or-sixth-form-college-corporation",
                "assurance-company",
                "old-public-company",
                "unregistered-company",
                "converted-or-closed"
              ],
              "enumTitles": [
                "Private limited company",
                "Public limited company",
                "Limited liability partnership",
                "Limited partnership",
                "Private unlimited company",
                "Private unlimited company without share capital",
                "Private limited by guarantee without share capital",
                "Private limited by guarantee without share capital, 'Limited' exemption",
                "Private limited company, 'Limited' exemption",
                "Overseas company",
                "Overseas entity",
                "UK establishment company",
                "Charitable incorporated organisation",
                "Scottish charitable incorporated organisation",
                "Scottish qualifying partnership",
                "Industrial and Provident society",
                "Registered society",
                "Royal charter company",
                "Investment company with variable capital",
                "Protected cell company",
                "European Economic Interest Grouping (EEIG)",
                "European public limited liability company (SE)",
                "Further education or sixth form college corporation",
                "Assurance company",
                "Old public company",
                "Unregistered company",
                "Converted or closed"
              ]
            }
          },
          "ukStatus": {
            "title": "UK company status",
            "type": "array",
            "description": "Optional. Company statuses to include, for example Active or Dissolved.",
            "items": {
              "type": "string",
              "enum": [
                "active",
                "dissolved",
                "open",
                "closed",
                "converted-closed",
                "removed",
                "receivership",
                "liquidation",
                "administration",
                "insolvency-proceedings",
                "voluntary-arrangement"
              ],
              "enumTitles": [
                "Active",
                "Dissolved",
                "Open",
                "Closed",
                "Converted closed",
                "Removed",
                "Receivership",
                "Liquidation",
                "Administration",
                "Insolvency proceedings",
                "Voluntary arrangement"
              ]
            }
          },
          "ukIncorporatedFrom": {
            "title": "UK incorporated from",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Optional. Incorporated on or after this date (YYYY-MM-DD)."
          },
          "ukIncorporatedTo": {
            "title": "UK incorporated to",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Optional. Incorporated on or before this date (YYYY-MM-DD)."
          },
          "ukDissolvedFrom": {
            "title": "UK dissolved from",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Optional. Dissolved on or after this date (YYYY-MM-DD)."
          },
          "ukDissolvedTo": {
            "title": "UK dissolved to",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Optional. Dissolved on or before this date (YYYY-MM-DD)."
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum number of matching company records to return. Set higher for bulk-enrichment workflows; lower for one-off lookups.",
            "default": 25
          },
          "includeDetails": {
            "title": "Include Detailed Info",
            "type": "boolean",
            "description": "When enabled, SEC rows are filled from the SEC company record (entity type, industry, state of incorporation, location, tickers). Disable for a faster list of name + CIK.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}