> **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).

# listAvailableTrackerRules

`GET /v1/tracker/rules`

**Tags:** `Tracker`

List available tracker rules

**Endpoint:** `https://api.fiber.ai/v1/tracker/rules`

## Description

Returns all available tracker rule types with descriptions, configuration schemas, example configs, and example signal payloads. Use this to discover what rules exist before creating tracker lists. The response is deterministic — same output on every call.

⚡ 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": {
        "companyRules": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Rule type slug used in config objects (e.g. headcount_crossed_threshold)."
              },
              "readableName": {
                "type": "string",
                "description": "Human-readable name for this rule type."
              },
              "entityType": {
                "type": "string",
                "enum": [
                  "company",
                  "person"
                ],
                "description": "Whether this rule applies to company or person lists."
              },
              "description": {
                "type": "string",
                "description": "What change this rule detects and when it fires."
              },
              "useCase": {
                "type": "string",
                "description": "Sales-oriented example of why you would use this rule."
              },
              "supportsInitialSignals": {
                "type": "boolean",
                "description": "Whether this rule supports immediate initial signals on entity addition."
              },
              "config": {
                "type": "object",
                "properties": {
                  "schema": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "JSON Schema for the rule config object. Pass a config conforming to this schema when creating a tracker list rule."
                  },
                  "example": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "A valid example config you can pass directly to create a rule."
                  }
                },
                "required": [
                  "schema",
                  "example"
                ],
                "description": "Config schema and example for creating this rule type."
              },
              "signal": {
                "type": "object",
                "properties": {
                  "schema": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "JSON Schema for each item in the changeData array. When this rule fires, the signal contains one or more changeData items conforming to this schema."
                  },
                  "example": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "A concrete changeData item example matching the schema above."
                  }
                },
                "required": [
                  "schema",
                  "example"
                ],
                "description": "Signal output schema and example for this rule type."
              }
            },
            "required": [
              "name",
              "readableName",
              "entityType",
              "description",
              "useCase",
              "supportsInitialSignals",
              "config",
              "signal"
            ]
          },
          "description": "All available company tracking rule types."
        },
        "personRules": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Rule type slug used in config objects (e.g. headcount_crossed_threshold)."
              },
              "readableName": {
                "type": "string",
                "description": "Human-readable name for this rule type."
              },
              "entityType": {
                "type": "string",
                "enum": [
                  "company",
                  "person"
                ],
                "description": "Whether this rule applies to company or person lists."
              },
              "description": {
                "type": "string",
                "description": "What change this rule detects and when it fires."
              },
              "useCase": {
                "type": "string",
                "description": "Sales-oriented example of why you would use this rule."
              },
              "supportsInitialSignals": {
                "type": "boolean",
                "description": "Whether this rule supports immediate initial signals on entity addition."
              },
              "config": {
                "type": "object",
                "properties": {
                  "schema": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "JSON Schema for the rule config object. Pass a config conforming to this schema when creating a tracker list rule."
                  },
                  "example": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "A valid example config you can pass directly to create a rule."
                  }
                },
                "required": [
                  "schema",
                  "example"
                ],
                "description": "Config schema and example for creating this rule type."
              },
              "signal": {
                "type": "object",
                "properties": {
                  "schema": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "JSON Schema for each item in the changeData array. When this rule fires, the signal contains one or more changeData items conforming to this schema."
                  },
                  "example": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "A concrete changeData item example matching the schema above."
                  }
                },
                "required": [
                  "schema",
                  "example"
                ],
                "description": "Signal output schema and example for this rule type."
              }
            },
            "required": [
              "name",
              "readableName",
              "entityType",
              "description",
              "useCase",
              "supportsInitialSignals",
              "config",
              "signal"
            ]
          },
          "description": "All available person tracking rule types."
        },
        "totalRuleCount": {
          "type": "integer",
          "minimum": 0,
          "description": "Total number of available rule types across both entity types."
        }
      },
      "required": [
        "companyRules",
        "personRules",
        "totalRuleCount"
      ]
    },
    "chargeInfo": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-now"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged"
          ],
          "description": "Credits were charged immediately for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charging-later"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "Credits will be charged after the operation completes"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-for-async-process"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged",
            "message"
          ],
          "description": "Credits that were charged for an asynchronous operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "free"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "No credits were charged for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "credits-refunded"
              ]
            },
            "creditsRefunded": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsRefunded",
            "message"
          ],
          "description": "Credits were refunded for this operation"
        }
      ]
    },
    "warnings": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Full path to extraneous field (e.g., 'searchParams.ExtraField')"
          },
          "message": {
            "type": "string",
            "description": "Warning message"
          }
        },
        "required": [
          "field",
          "message"
        ]
      },
      "description": "Warnings about extraneous fields in request"
    },
    "advice": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Tips, recommendations, and suggestions for using this API effectively."
    }
  },
  "required": [
    "output",
    "chargeInfo"
  ],
  "additionalProperties": false
}
```

---

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)
