{
  "openapi": "3.0.1",
  "info": {
    "title": "Secretary of State Business Entity Search - 23 States KYB",
    "description": "Secretary of State business entity search across 23 states. Agent, officer or street in CO, CT, FL, NY, OR, RI. AR: agent. WV: agent, street. PA: officer, street. MN, VT, PA, OR, CO, CT, NY, FL, ID, ND, AR, KY, DE, RI, WV file numbers. Filings, former names in FL, KY, NY, CO, CT, MN, RI, WV. CA key.",
    "version": "0.0",
    "x-build-id": "BH560oK2s9GIi0rI8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~us-business-entity-search/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-us-business-entity-search",
        "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/memo23~us-business-entity-search/runs": {
      "post": {
        "operationId": "runs-sync-memo23-us-business-entity-search",
        "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/memo23~us-business-entity-search/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-us-business-entity-search",
        "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": {
          "companyNames": {
            "title": "Businesses to look up",
            "type": "array",
            "description": "One name per line, e.g. Starbucks or Goldman Sachs. Every name is searched in every state chosen below; blank lines and repeats are dropped. LLC, Inc, Corp and similar words can be left off. Leave this empty for a registered-agent, officer or street search, or for a Texas taxpayer number, EIN, SOS file number, a Minnesota file number, a Vermont entity number, a Pennsylvania filing number, an Oregon registry number, a Colorado entity id, a Connecticut account number or filing number, a New York DOS id or filing number, a Florida document number, an Idaho filing number, a North Dakota filing number, an Arkansas filing number, a Kentucky organization number, a Delaware file number, a Rhode Island identification number or filing number, a West Virginia record id, or a Texas filter.",
            "items": {
              "type": "string"
            }
          },
          "agentNames": {
            "title": "Registered agents",
            "type": "array",
            "description": "Find businesses by registered agent. Arkansas, Colorado, Connecticut, Florida, New York, Oregon, Rhode Island and West Virginia. Arkansas ignores spaces in the name. Rhode Island uses the first 20 characters of the name. West Virginia uses the first 50 characters. Other selected states are left out of this lookup. Company, LLC and Inc stay part of the name.",
            "items": {
              "type": "string"
            }
          },
          "officerNames": {
            "title": "Officers",
            "type": "array",
            "description": "Find businesses by an officer or authorized person. Connecticut, Florida, New York, Oregon, Pennsylvania and Rhode Island. In Florida, First Last is accepted. In New York this is the chairman or CEO on the record. In Pennsylvania this is a party on the registration. In Rhode Island, First Last is accepted. Other selected states are left out of this lookup.",
            "items": {
              "type": "string"
            }
          },
          "streetAddresses": {
            "title": "Street addresses",
            "type": "array",
            "description": "Find businesses by a street the registry publishes. Colorado, Connecticut, Florida, New York, Oregon, Pennsylvania, Rhode Island and West Virginia. In New York this is the principal location street. In Pennsylvania this is the address on the registration. In Rhode Island and West Virginia, exact still matches when the city, state and ZIP follow the street. A city or ZIP on its own belongs in the Texas filters.",
            "items": {
              "type": "string"
            }
          },
          "matchMode": {
            "title": "How names must match",
            "enum": [
              "contains",
              "startsWith",
              "exact"
            ],
            "type": "string",
            "description": "Contains (default) finds your text anywhere in the registered name. Starts with needs it at the beginning. Exact compares the whole name with punctuation and LLC/Inc-type words ignored, so Goldman Sachs finds GOLDMAN SACHS & CO. LLC. For a registered agent, officer or street, Exact keeps Company, LLC and Inc. Florida and Iowa can only search a company name from the start, so Contains behaves like Starts with there.",
            "default": "contains"
          },
          "states": {
            "title": "Secretary of State registries",
            "type": "array",
            "description": "The states to search. Empty: every supported state that needs no key, plus California when a California key is set below.",
            "items": {
              "type": "string",
              "enum": [
                "FL",
                "TX",
                "NY",
                "CO",
                "CT",
                "OR",
                "MN",
                "ID",
                "WV",
                "KY",
                "NJ",
                "AL",
                "ND",
                "IA",
                "WI",
                "PA",
                "AR",
                "RI",
                "MO",
                "DE",
                "VT",
                "DC",
                "CA"
              ],
              "enumTitles": [
                "Florida (Sunbiz)",
                "Texas",
                "New York",
                "Colorado",
                "Connecticut",
                "Oregon",
                "Minnesota",
                "Idaho",
                "West Virginia",
                "Kentucky",
                "New Jersey",
                "Alabama",
                "North Dakota",
                "Iowa",
                "Wisconsin",
                "Pennsylvania",
                "Arkansas",
                "Rhode Island",
                "Missouri",
                "Delaware",
                "Vermont",
                "District of Columbia",
                "California (needs API key)"
              ]
            }
          },
          "caApiKey": {
            "title": "California registry key (optional)",
            "type": "string",
            "description": "A free key from the California Secretary of State (calicodev.sos.ca.gov). Needed only for California; without it California is left out of an all-states run."
          },
          "taxpayerNumbers": {
            "title": "Texas taxpayer numbers or EINs",
            "type": "array",
            "description": "Texas only. 11-digit Comptroller taxpayer numbers or 9-digit federal EINs, one per line. Dashes are fine. A run can be just these numbers, with no company name.",
            "items": {
              "type": "string"
            }
          },
          "fileNumbers": {
            "title": "File numbers",
            "type": "array",
            "description": "Texas SOS file numbers, 6 to 10 digits. Leading zeros are optional. Minnesota file numbers as printed, such as 3834-LFC. 3834 does not match 3834-LFC. Vermont entity numbers, such as 74657. Leading zeros are ignored, and 7465 does not match 74657. Pennsylvania filing numbers are 10 digits, so 159516 matches 0000159516. Oregon registry numbers, such as 8739914. Colorado entity ids, such as 19981033526. Leading zeros are dropped in Oregon and Colorado. 873991 does not match 8739914. 1998103352 does not match 19981033526. Connecticut account numbers, such as 0287916. Leading zeros stay, so 287916 does not match 0287916, and 028791 does not match 0287916. Connecticut filing numbers are 10 digits, such as 0005799067, or start with letters, such as BF-0010157714. 0005799068 does not match 0005799067. The record id is the account number. New York DOS ids, such as 1701167. Leading zeros stay, so 01701167 does not match 1701167, and 170116 does not match 1701167. New York filing numbers start with a letter, such as A171209-5. A171209-6 does not match it. The result is that company. Florida document numbers, such as 112252 or L17000138980. Letters and leading zeros stay, so 11225 does not match 112252, and 0112252 does not match 112252. Idaho filing numbers, such as 98318. Leading zeros are dropped, so 0000098318 matches 98318. 9831 does not match 98318. North Dakota filing numbers, such as 10610. Leading zeros are dropped, so 0000010610 matches 10610. 1061 does not match 10610, and 106100 does not match 10610. Arkansas filing numbers, such as 100067582. Leading zeros stay, so 0100067582 does not match 100067582, and 10006758 does not match 100067582. Kentucky organization numbers, such as 0059256. Leading zeros are dropped, so 59256 matches 0059256, and 005925 does not match 0059256. The result is the organization. Assumed names under that number are left out. Delaware file numbers, such as 4290350. Leading zeros are dropped, so 04290350 matches 4290350, and 429035 does not match 4290350. Rhode Island identification numbers are 9 digits, such as 000015908. Leading zeros stay, so 15908 does not match 000015908, and 000001590 is a different company. Rhode Island filing numbers are 12 digits, such as 202689281200. 202689281201 does not match it, and 20268928120 stays out. That result is the company name on the filing. West Virginia record ids, such as 294278. Leading zeros are dropped, so 0294278 matches 294278, and 29427 does not match 294278. Each state runs when it is selected. A run can be just these numbers.",
            "items": {
              "type": "string"
            }
          },
          "formedAfter": {
            "title": "Texas formed on or after",
            "type": "string",
            "description": "Texas only. Entities chartered on or after this date, YYYY-MM-DD. With no company name, the run lists matching Texas entities, newest first, up to Records in total."
          },
          "formedBefore": {
            "title": "Texas formed on or before",
            "type": "string",
            "description": "Texas only. Entities chartered on or before this date, YYYY-MM-DD."
          },
          "cities": {
            "title": "Texas cities",
            "type": "array",
            "description": "Texas only. Mailing city on the Comptroller record, e.g. Houston or Austin.",
            "items": {
              "type": "string"
            }
          },
          "counties": {
            "title": "Texas counties",
            "type": "array",
            "description": "Texas only. County name or Comptroller county code, e.g. Harris or 101.",
            "items": {
              "type": "string"
            }
          },
          "zipCodes": {
            "title": "Texas ZIP codes",
            "type": "array",
            "description": "Texas only. A 5-digit ZIP, or a prefix such as 770.",
            "items": {
              "type": "string"
            }
          },
          "naicsCodes": {
            "title": "Texas NAICS codes",
            "type": "array",
            "description": "Texas only. NAICS code or prefix, 2 to 6 digits, e.g. 238 for construction. Entities with no NAICS on file are left out of a NAICS filter.",
            "items": {
              "type": "string"
            }
          },
          "entityTypes": {
            "title": "Texas entity types",
            "type": "array",
            "description": "Texas only. LLC, corporation, nonprofit, limited partnership, general partnership, trust, association, or a Comptroller code such as CL.",
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "Read each entity's full record",
            "type": "boolean",
            "description": "On (default): each record also carries officers, the registered agent and addresses, plus the newest filings and former names where that registry publishes them. Off: name, file number, type and status only, which is quicker for checking whether a business exists.",
            "default": true
          },
          "includeLiens": {
            "title": "Include UCC filings",
            "type": "boolean",
            "description": "On: Alabama, Arkansas, Colorado, Connecticut, Florida, Idaho, Kentucky, Rhode Island and Wisconsin records also include UCC filings against that exact company name, with the file number, filing date, secured party, and whether the filing was terminated or continued. Alabama, Arkansas, Colorado and Rhode Island add the date and status when the filing prints them. Arkansas adds the debtor city. Colorado and Rhode Island add the collateral when the filing prints it. Other states come back with lien coverage unavailable until they are added. Off (default).",
            "default": false
          },
          "activeOnly": {
            "title": "Skip inactive entities",
            "type": "boolean",
            "description": "On: dissolved, withdrawn, revoked and other inactive entities are left out and not billed. Entities whose status the registry does not give are kept.",
            "default": false
          },
          "onlyNew": {
            "title": "Only records not returned before",
            "type": "boolean",
            "description": "On: a later run with the same memory skips entities this actor already returned, and those rows are not billed. The first run returns the current matches and remembers them. Use a charter-date window for a weekly list of new Texas entities. Off (default).",
            "default": false
          },
          "monitorName": {
            "title": "Memory name",
            "type": "string",
            "description": "Names the memory used by Only records not returned before. The same name shares one memory. Empty uses one memory for this actor. A different name starts a separate list, for example one per city."
          },
          "maxItems": {
            "title": "Records in total",
            "minimum": 1,
            "type": "integer",
            "description": "The run stops after this many records across all names and states, or earlier at your spending limit.",
            "default": 1000
          },
          "maxResultsPerState": {
            "title": "Records per name in each state",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "The most records one name can return from one state, 1 to 200.",
            "default": 10
          },
          "maxConcurrency": {
            "title": "Registries searched at once",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "1 to 10, default 4.",
            "default": 4
          },
          "proxy": {
            "title": "Proxy (optional)",
            "type": "object",
            "description": "The registries are public and normally answer without a proxy. Add one only if a state starts refusing the run."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}