{
  "openapi": "3.0.1",
  "info": {
    "title": "Multi-State Corporate & Business Entity Registry (CO, CT, OR)",
    "description": "Search official Colorado, Connecticut, and Oregon business registries by company name or state registry ID. Return public registry status, formation details, addresses, agent contacts when available, and official source links.",
    "version": "1.0",
    "x-build-id": "POPxg3Dp9X5bGBG7g"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/muhammadafzal~co-ct-or-business-entity-registry/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-muhammadafzal-co-ct-or-business-entity-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/muhammadafzal~co-ct-or-business-entity-registry/runs": {
      "post": {
        "operationId": "runs-sync-muhammadafzal-co-ct-or-business-entity-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/muhammadafzal~co-ct-or-business-entity-registry/run-sync": {
      "post": {
        "operationId": "run-sync-muhammadafzal-co-ct-or-business-entity-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",
        "required": [
          "searchTerms"
        ],
        "properties": {
          "searchTerms": {
            "title": "Business names or registry IDs",
            "minItems": 1,
            "maxItems": 20,
            "type": "array",
            "description": "Use this to find one or more companies by legal name or state registry ID. Enter one value per line, for example NIKE, INC. or 8739914. Defaults to NIKE, INC. Enter up to 20 values. This is not an owner, EIN, address, or name-availability search.",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 120
            },
            "default": [
              "NIKE, INC."
            ]
          },
          "states": {
            "title": "States to search",
            "minItems": 1,
            "maxItems": 3,
            "uniqueItems": true,
            "type": "array",
            "description": "Use this to choose the official registries to search. Enter CO, CT, and/or OR, one per line. Defaults to all three states.",
            "items": {
              "type": "string"
            },
            "default": [
              "CO",
              "CT",
              "OR"
            ]
          },
          "searchBy": {
            "title": "Search terms are",
            "enum": [
              "name",
              "registryId"
            ],
            "type": "string",
            "description": "Choose name to search the business name, or registryId to match a state-issued registry number exactly. Registry IDs contain digits only; different states use different ID formats.",
            "default": "name"
          },
          "matchMode": {
            "title": "Business name matching",
            "enum": [
              "contains",
              "beginsWith",
              "exact"
            ],
            "type": "string",
            "description": "Use contains to find the term anywhere in a company name, beginsWith to match the start, or exact to require the full name. This setting is ignored for registry ID searches.",
            "default": "exact"
          },
          "maxResultsPerSearch": {
            "title": "Maximum records per term and state",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Use this to bound candidate records returned for each search term in each selected state. Enter 1 to 50. Defaults to 10. The separate total result limit applies across all terms and states.",
            "default": 10
          },
          "maxTotalResults": {
            "title": "Maximum total result records",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Use this to cap unique records across the complete run. Enter 1 to 500; defaults to 25. Free-plan users are capped at 5 records per run. At the FREE price tier, estimated event charges are up to $0.005 for the run start plus $0.01 per returned record.",
            "default": 25
          },
          "includeRegisteredAgent": {
            "title": "Include registered agent details",
            "type": "boolean",
            "description": "Use this to include a registered agent name and address when the selected state's public registry exposes them. Defaults to true. These are registry-listed contacts, not beneficial owners or a verification of control.",
            "default": true
          },
          "requestDelayMs": {
            "title": "Delay between source requests (milliseconds)",
            "minimum": 100,
            "maximum": 5000,
            "type": "integer",
            "description": "Use this to pace requests to the state open-data APIs. Enter 100 to 5000 milliseconds. Defaults to 350 milliseconds; retries add backoff automatically.",
            "default": 350
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}