{
  "openapi": "3.0.1",
  "info": {
    "title": "New Business Filings Feed: CO, NY, CT & OR Registrations Daily",
    "description": "Every newly registered business in Colorado, New York, Connecticut and Oregon from the states' official open-data registries: name, entity type, formation date, address, registered agent (formation services flagged), NAICS and email where published. Only new rows on schedules. From $0.60 per 1,000.",
    "version": "0.2",
    "x-build-id": "OwPZ2XFEQYI1geHb7"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/upward_enterprises~new-business-filings-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-upward_enterprises-new-business-filings-feed",
        "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/upward_enterprises~new-business-filings-feed/runs": {
      "post": {
        "operationId": "runs-sync-upward_enterprises-new-business-filings-feed",
        "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/upward_enterprises~new-business-filings-feed/run-sync": {
      "post": {
        "operationId": "run-sync-upward_enterprises-new-business-filings-feed",
        "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": [
          "states"
        ],
        "properties": {
          "states": {
            "title": "States",
            "type": "array",
            "description": "Which state registries to read. Each is the state's official open-data dataset of business entities.",
            "items": {
              "type": "string",
              "enum": [
                "CO",
                "NY",
                "CT",
                "OR"
              ],
              "enumTitles": [
                "Colorado (Secretary of State, data.colorado.gov)",
                "New York (Department of State, data.ny.gov)",
                "Connecticut (Secretary of the State, data.ct.gov)",
                "Oregon (Secretary of State, data.oregon.gov)"
              ]
            }
          },
          "filedWithinDays": {
            "title": "Formed within (days)",
            "minimum": 0,
            "maximum": 30,
            "type": "integer",
            "description": "How far back to look by formation or registration date, in calendar days before today, plus today. Default 4: Colorado publishes with a lag of about three days, the others one day, and \"Only new since last run\" makes overlapping windows safe.",
            "default": 4
          },
          "entityClasses": {
            "title": "Entity classes",
            "type": "array",
            "description": "Keep only these kinds of entity. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "LLC",
                "Corporation",
                "Nonprofit",
                "Partnership",
                "Assumed name",
                "Other"
              ],
              "enumTitles": [
                "LLC (including professional LLCs)",
                "Corporation (business, professional, benefit)",
                "Nonprofit / not-for-profit / non-stock",
                "Partnership (LP, LLP)",
                "Assumed business name / DBA (Oregon)",
                "Other (reserved names, cooperatives, trusts)"
              ]
            },
            "default": []
          },
          "domesticOnly": {
            "title": "Domestic entities only",
            "type": "boolean",
            "description": "On (default): only entities formed in the state, which is where the new businesses are. Off: also out-of-state entities registering to do business there.",
            "default": true
          },
          "excludeFormationServiceAgents": {
            "title": "Skip entities whose registered agent is a formation service",
            "type": "boolean",
            "description": "Off (default): every entity is delivered and the agent is flagged as formation-service, organization, or individual. On: skip entities registered through services such as Northwest Registered Agent, LegalZoom, ZenBusiness, or CSC.",
            "default": false
          },
          "nameKeywords": {
            "title": "Name keywords",
            "type": "array",
            "description": "Only entities whose name contains any of these words, case-insensitive, e.g. \"roofing\", \"dental\", \"consulting\". Empty means every name.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "zipPrefixes": {
            "title": "ZIP code prefixes",
            "type": "array",
            "description": "Only entities whose principal address ZIP starts with one of these, e.g. 802 for Denver, 100 for Manhattan. Empty means anywhere.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "counties": {
            "title": "Counties (New York only)",
            "type": "array",
            "description": "New York publishes the county; other states do not. Case-insensitive, e.g. Kings, Queens, Erie. Empty means all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "naicsPrefixes": {
            "title": "NAICS prefixes (Connecticut only)",
            "type": "array",
            "description": "Connecticut publishes each business's NAICS code; other states do not, and their rows pass this filter untouched. E.g. 23 (construction), 541 (professional services).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "onlyNew": {
            "title": "Only new since last run",
            "type": "boolean",
            "description": "On (default): remember which entities each snapshot name has delivered (90 days) and skip them next time, so a schedule never bills the same business twice. Off: deliver everything in the window every run.",
            "default": true
          },
          "snapshotName": {
            "title": "Snapshot name",
            "type": "string",
            "description": "Which memory \"only new\" uses. Kept on your account as a key-value store named new-business-filings-feed-<name>. Give each schedule its own name.",
            "default": "default"
          },
          "maxItems": {
            "title": "Max entities per run",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Upper limit on delivered rows, newest first. The summary row says whether the limit cut the results.",
            "default": 2000
          },
          "socrataAppToken": {
            "title": "Socrata app token (optional)",
            "type": "string",
            "description": "A free app token from any of the four data portals raises the portals' request limits. Not needed for daily runs."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}