# searchFormDFilings

**Identifier:** `sec_searchFormDFilings`

**Provider:** [SEC](https://kirha.com/providers/sec.md)

Screen recent Form D filings (US private placements: startup equity rounds, SPVs, fund raises) by filing date, industry group, issuer state and offering size, with each filing parsed (amounts raised, investor count, first sale date, exemptions, executives). Freshest public signal of private fundraising, usually filed within 15 days of the first sale. Scans at most 100 filings per call, so narrow the date range for exhaustive screens. Use getFormDFilings for one company's history.

## Run it with the CLI

```bash
kirha tools run sec_searchFormDFilings \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "sec_searchFormDFilings",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "endDate": {
      "description": "Filing date YYYY-MM-DD. Defaults to today",
      "type": "string"
    },
    "excludePooledFunds": {
      "default": true,
      "description": "Hide fund/SPV raises (over half of all Form D) to keep operating companies",
      "type": "boolean"
    },
    "includeAmendments": {
      "default": false,
      "description": "Include D/A amendments",
      "type": "boolean"
    },
    "industryGroup": {
      "enum": [
        "Agriculture",
        "Airlines and Airports",
        "Biotechnology",
        "Business Services",
        "Coal Mining",
        "Commercial",
        "Commercial Banking",
        "Computers",
        "Construction",
        "Electric Utilities",
        "Energy Conservation",
        "Environmental Services",
        "Health Insurance",
        "Hospitals and Physicians",
        "Insurance",
        "Investing",
        "Investment Banking",
        "Lodging and Conventions",
        "Manufacturing",
        "Oil and Gas",
        "Other",
        "Other Banking and Financial Services",
        "Other Energy",
        "Other Health Care",
        "Other Real Estate",
        "Other Technology",
        "Other Travel",
        "Pharmaceuticals",
        "Pooled Investment Fund",
        "REITS and Finance",
        "Residential",
        "Restaurants",
        "Retailing",
        "Telecommunications",
        "Tourism and Travel Services"
      ],
      "type": "string"
    },
    "keywords": {
      "description": "Full-text terms in the filing, e.g. issuer or executive name",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "number"
    },
    "minOfferingAmountUsd": {
      "description": "On total offering amount, or amount sold",
      "minimum": 0,
      "type": "number"
    },
    "startDate": {
      "description": "Filing date YYYY-MM-DD. Defaults to 7 days ago",
      "type": "string"
    },
    "state": {
      "description": "Issuer business state, e.g. CA, NY",
      "maxLength": 2,
      "minLength": 2,
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "accessionNumbers": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "ciks": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "filings": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "accessionNo": {
            "type": "string"
          },
          "cik": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "companyName": {
            "type": "string"
          },
          "dateOfFirstSale": {
            "type": "string"
          },
          "entityType": {
            "type": "string"
          },
          "exemptions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "filedAt": {
            "type": "string"
          },
          "filingUrl": {
            "type": "string"
          },
          "formType": {
            "type": "string"
          },
          "industryGroup": {
            "type": "string"
          },
          "investmentFundType": {
            "type": "string"
          },
          "investorCount": {
            "description": "Investors who already invested",
            "type": "number"
          },
          "isAmendment": {
            "type": "boolean"
          },
          "issuerSize": {
            "description": "Revenue range, or net asset value range for funds",
            "type": "string"
          },
          "jurisdictionOfIncorporation": {
            "type": "string"
          },
          "minimumInvestmentUsd": {
            "type": "number"
          },
          "nonAccreditedInvestorCount": {
            "type": "number"
          },
          "placementAgents": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "relatedPersons": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "clarification": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "relationships": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "name",
                "relationships"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "securitiesOffered": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "state": {
            "type": "string"
          },
          "totalAmountSoldUsd": {
            "type": "number"
          },
          "totalOfferingAmountUsd": {
            "description": "Absent when the offering size is Indefinite",
            "type": "number"
          },
          "totalRemainingUsd": {
            "type": "number"
          },
          "yearOfIncorporation": {
            "type": "string"
          }
        },
        "required": [
          "accessionNo",
          "formType",
          "filedAt",
          "filingUrl",
          "cik",
          "companyName",
          "isAmendment",
          "exemptions",
          "securitiesOffered",
          "placementAgents",
          "relatedPersons"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "scannedFilings": {
      "type": "number"
    },
    "totalFilingsInIndex": {
      "description": "efts matches before industry/amount verification",
      "type": "number"
    }
  },
  "required": [
    "context",
    "totalFilingsInIndex",
    "scannedFilings",
    "filings",
    "accessionNumbers",
    "ciks"
  ],
  "type": "object"
}
```

## Related tools

Other SEC tools that this tool refers to, or that refer to it.

- [`getFormDFilings`](https://kirha.com/providers/sec/getFormDFilings.md)

-----

[All SEC tools](https://kirha.com/providers/sec.md) · [< Back to tools list](https://kirha.com/tools.md)