> **For AI agents:** this page is a focused, LLM-optimized view of a
> single Fiber AI operation. Before calling it, fetch the routing
> instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation
> index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md).

# listTrackerCompanyLists

`GET /v1/tracker/company-lists`

**Tags:** `Tracker`

List company tracker lists

**Endpoint:** `https://api.fiber.ai/v1/tracker/company-lists`

## Description

List all company tracker lists for your organization.

⚡ Rate limit: 120 requests per 1 minute

💰 Cost: FREE! No credits are charged for this API. ⓘ

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `apiKey` | query | yes | Your Fiber API key |

## Response — success (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "output": {
      "type": "object",
      "properties": {
        "lists": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Tracker list ID."
              },
              "name": {
                "type": "string",
                "description": "Name of the list."
              },
              "refreshIntervalDays": {
                "type": "integer",
                "description": "Check interval in days."
              },
              "trackingRules": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "headcount_crossed_threshold"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "above",
                            "below"
                          ],
                          "description": "Whether to alert when headcount crosses the threshold going up or down"
                        },
                        "threshold": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "description": "The employee count threshold to watch for crossing. Any positive integer is accepted."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "direction",
                        "threshold",
                        "id"
                      ],
                      "title": "Headcount crossed threshold"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "headcount_growth_percent"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "minPercentChange": {
                          "type": "number",
                          "exclusiveMinimum": 0,
                          "maximum": 1000,
                          "description": "Minimum percent change to trigger (e.g. 20 means 20% growth)"
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "grew",
                            "shrank",
                            "either"
                          ],
                          "description": "Whether to alert on growth, shrinkage, or either"
                        },
                        "minStartingHeadcount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "exclusiveMinimum": 0,
                          "description": "Only alert if the company had at least this many employees before the change. Omit for any starting size."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "minPercentChange",
                        "direction",
                        "id"
                      ],
                      "title": "Headcount growth percent"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "new_funding_round"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "minAmountUsd": {
                          "type": [
                            "number",
                            "null"
                          ],
                          "minimum": 0,
                          "description": "Only alert for rounds above this amount. Omit for any amount."
                        },
                        "roundTypes": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "enum": [
                              "pre_seed",
                              "seed",
                              "angel",
                              "series_a",
                              "series_b",
                              "series_c",
                              "series_d",
                              "series_e",
                              "series_f",
                              "series_g",
                              "private_equity",
                              "debt_financing",
                              "grant",
                              "convertible_note",
                              "corporate_round",
                              "undisclosed"
                            ]
                          },
                          "minItems": 1,
                          "description": "Round types to alert on. Defaults to equity-focused types when omitted. Set explicitly to include debt/grant types."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "New funding round"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "funding_stage_changed"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "toStages": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "enum": [
                              "pre_seed",
                              "seed",
                              "series_a",
                              "series_b",
                              "series_c",
                              "series_d",
                              "series_e",
                              "series_f",
                              "series_g",
                              "private_equity",
                              "public",
                              "acquired"
                            ]
                          },
                          "minItems": 1,
                          "description": "Only alert if new stage is one of these. Omit for any stage change."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Funding stage changed"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "job_posting_with_keyword"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "keywords": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "Alert when a job posting contains any of these keywords in the selected search fields."
                        },
                        "searchFields": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "enum": [
                              "title",
                              "description"
                            ]
                          },
                          "minItems": 1,
                          "description": "Job posting fields to search for the keywords. Omit to search the title only."
                        },
                        "seniorityLevels": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "enum": [
                              "Internship",
                              "Entry level",
                              "Associate",
                              "Mid-Senior level",
                              "Director",
                              "Executive"
                            ]
                          },
                          "minItems": 1,
                          "description": "Only alert for these seniority levels. Omit for any level."
                        },
                        "modalities": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "enum": [
                              "On-site",
                              "Remote",
                              "Hybrid"
                            ]
                          },
                          "minItems": 1,
                          "description": "Only alert for these job modalities. Omit for any."
                        },
                        "locationTypes": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "enum": [
                              "remote",
                              "on_site",
                              "hybrid"
                            ]
                          },
                          "minItems": 1,
                          "description": "Deprecated. Use modalities instead.",
                          "deprecated": true
                        },
                        "minPostings": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "exclusiveMinimum": 0,
                          "description": "Only alert if at least this many NEW matching postings are detected in a single check cycle. Omit for 1 (any new match)."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "keywords",
                        "id"
                      ],
                      "title": "Job posting with keyword"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "job_posting_in_function"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "jobFunctions": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "enum": [
                              "Accounting",
                              "Administrative",
                              "Advertising",
                              "Analyst",
                              "Art / Creative",
                              "Business Development",
                              "Community & Social Services",
                              "Consulting",
                              "Customer Service",
                              "Design",
                              "Distribution",
                              "Education",
                              "Engineering",
                              "Entrepreneurship",
                              "Finance",
                              "General Business",
                              "Health Care Provider",
                              "Human Resources",
                              "Information Technology",
                              "Legal",
                              "Management",
                              "Manufacturing",
                              "Marketing",
                              "Military & Protective Services",
                              "Other",
                              "Product Management",
                              "Production",
                              "Program & Product Management",
                              "Project Management",
                              "Public Relations",
                              "Purchasing",
                              "Quality Assurance",
                              "Real Estate",
                              "Research",
                              "Sales",
                              "Science",
                              "Strategy / Planning",
                              "Supply Chain",
                              "Training",
                              "Writing / Editing"
                            ]
                          },
                          "description": "Alert when a job posting is in any of these departments/functions."
                        },
                        "minPostings": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "exclusiveMinimum": 0,
                          "description": "Only alert if at least this many NEW matching postings are detected in a single check cycle. Omit for 1 (any new match)."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "jobFunctions",
                        "id"
                      ],
                      "title": "Job posting in function"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "news_with_keyword"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "keywords": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "Alert when a news article title or summary matches any keyword"
                        },
                        "sentiment": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "enum": [
                            "positive",
                            "negative",
                            "neutral",
                            null
                          ],
                          "description": "Only alert for news with this sentiment. Omit for any sentiment."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "keywords",
                        "id"
                      ],
                      "title": "News with keyword"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "company_news"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "sentiment": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "enum": [
                            "positive",
                            "negative",
                            "neutral",
                            null
                          ],
                          "description": "Only alert for news with this sentiment. Omit for any sentiment."
                        },
                        "minArticles": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "description": "Only alert when at least this many articles are detected in a single check. Useful for filtering noise from single tangential mentions. Omit for any count."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Company news"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "hq_location_changed"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "HQ location changed"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "company_status_changed"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "toStatuses": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "enum": [
                              "operating",
                              "acquired",
                              "closed",
                              "ipo",
                              "subsidiary"
                            ]
                          },
                          "minItems": 1,
                          "description": "Only alert if new status is one of these. Omit for any status change."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Company status changed"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "technology_added"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "technologies": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "Only alert for these technologies. Omit for any new technology."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Technology added"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "company_posted"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "minReactions": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 0,
                          "description": "Only alert for posts with at least this many reactions. Omit for any."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Company posted"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "company_posted_with_keyword"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "keywords": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "Alert for posts matching these keywords."
                        },
                        "minReactions": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 0,
                          "description": "Only alert for posts with at least this many reactions. Omit for any."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Company posted with keyword"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "follower_count_growth"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "minAbsoluteGrowth": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 0,
                          "description": "Minimum absolute follower increase to trigger. Omit or set to 0 for any increase."
                        },
                        "minPercentGrowth": {
                          "type": [
                            "number",
                            "null"
                          ],
                          "exclusiveMinimum": 0,
                          "description": "Minimum percent follower increase to trigger. Omit for any increase."
                        },
                        "minStartingFollowerCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "exclusiveMinimum": 0,
                          "description": "Only alert if the company had at least this many followers before the growth. Omit for any starting count."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Follower count growth"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "company_name_changed"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Company name changed"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "company_description_changed"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "keywords": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "Only alert if new description contains one of these keywords. Omit for any change."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Company description changed"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "company_went_inactive"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "description": "Fires when a company becomes inactive.",
                      "title": "Company went inactive"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "employee_count_milestone"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "milestone": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "description": "The employee count threshold to watch for crossing. Any positive integer is accepted. Equivalent to 'threshold' in headcount_crossed_threshold."
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "above",
                            "below"
                          ],
                          "description": "Whether to alert when crossing above or below the milestone"
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "milestone",
                        "direction",
                        "id"
                      ],
                      "description": "Fires when the employee count crosses the specified value. Supports any positive integer, not just round milestones. Functionally equivalent to headcount_crossed_threshold.",
                      "title": "Employee count milestone"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "new_office_location"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "countries": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$",
                            "minLength": 3,
                            "maxLength": 3
                          },
                          "minItems": 1,
                          "description": "ISO 3166-1 alpha-3 country codes (e.g. 'USA', 'GBR', 'DEU'). Only alert for offices in these countries. Omit for any new office."
                        },
                        "cities": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "City names (e.g. 'San Francisco', 'London', 'Berlin'). Only alert for offices in these cities. Omit for any new office."
                        },
                        "regions": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "Region codes (e.g. 'X-EMEA', 'X-APAC', 'X-EUROPE'). Expands to constituent country codes. Omit for any."
                        },
                        "states": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "State or province names (e.g. 'California', 'Ontario'). Omit for any."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "New office location"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "company_logo_changed"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Company logo changed"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "acquired_company"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "minPriceUsd": {
                          "type": [
                            "number",
                            "null"
                          ],
                          "minimum": 0,
                          "description": "Only alert for acquisitions above this price. Omit for any acquisition."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "Acquired company"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "new_investor"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "investorNames": {
                          "type": [
                            "array",
                            "null"
                          ],
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "Only alert when a new investor's name matches one of these (exact, case-insensitive). Omit for any new investor."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "id"
                      ],
                      "title": "New investor"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "recently_hired_with_title"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "titleKeywords": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "minItems": 1,
                          "description": "Title keywords to search for. Fires when the company hires someone whose title matches any keyword."
                        },
                        "minNewHires": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "exclusiveMinimum": 0,
                          "description": "Minimum number of NEW hires detected in a single check cycle to trigger the alert. Only counts employees who appeared since the last check. Omit for 1."
                        },
                        "id": {
                          "type": "string",
                          "description": "Unique rule ID. Use with removeRuleIds to delete a specific rule."
                        }
                      },
                      "required": [
                        "isDummy",
                        "type",
                        "entityType",
                        "titleKeywords",
                        "id"
                      ],
                      "title": "Recently hired with title"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "lookbackDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "maximum": 90,
                          "description": "Compare against a snapshot from approximately N days ago instead of the most recent prior snapshot. Omit for the default previous-snapshot comparison. Maximum 90 days."
                        },
                        "isDummy": {
                          "type": "boolean",
                          "description": "When true, this rule only fires via the fire-dummy endpoint and is skipped during normal pipeline runs."
                        },
                        "type": {
                          "type": "string",
                          "const": "department_size_threshold"
                        },
                        "entityType": {
                          "type": "string",
                          "const": "company"
                        },
                        "department": {
                          "type": "string",
                          "enum": [
                            "Accounting",
                            "Administrative",
                            "Advertising",
                            "Analyst",
                            "Art / Creative",
                            "Business Development",
                            "Community & Social Services",
                            "Consulting",
                            "Customer Service",
                            "Design",
                            "Distribution",
                            "Education",
                            "Engineering",
                            "Entrepreneurship",
                            "Finance",
                            "General Business",
                            "Health Care Provider",
                            "Human Resources",
                            "Information Technology",
                            "Legal",
                            "Management",
                            "Manufacturing",
                            "Marketing",
                            "Military & Protective Services",
                            "Other",
                            "Product Management",
                            "Production",
                            "Program & Product Management",
                            "Project Management",
                            "Public Relations",
                            "Purchasing",
                            "Quality Assurance",
                            "Real Estate",
                            "Research",
                            "Sales",
                            "Science",
                            "Strategy / Planning",
                            "Supply Chain",
                            "Training",
                            "Writing / Editing"
                          ],
                          "description": "Department to track. Matched against the company's organizational structure."
                        },
                        "threshold": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "description": "The employee count threshold to watch for crossing"
                        },
                        "direction": {
                          "type": "string",
   
… _truncated to 65536 chars for ai-docs._
```

---

Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json)
Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)