---
title: "Explain your tracker pricing tiers"
method: GET
path: "/v1/tracker/pricing-tiers"
tags: ["Tracker"]
---

# Explain your tracker pricing tiers

`GET /v1/tracker/pricing-tiers`

## Request

- Base URL: `https://api.fiber.ai`
- URL: `https://api.fiber.ai/v1/tracker/pricing-tiers`
- Auth: none declared

Returns the pricing tier each of your tracker lists will be billed at on its next scheduled refresh, with the per-entity cost, the two criteria that decided the tier, and the one change that would move each list to a cheaper tier. Tiers depend on how many companies and people your organization tracks in total and on each list's refresh cadence.

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> FREE! No credits are charged for this API.&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Query parameters

- `apiKey` string, required

## Response `200`

Default Response

- object
  - `output` object, required
    - `trackedEntityCount` integer, required: Active companies and people tracked across all of your lists, summed org-wide. This total decides tier eligibility for every list.
    - `usesCustomPricing` boolean, required: True when your organization has a negotiated per-entity rate that replaces the standard tiers. Most organizations are on the standard tiers (false).
    - `tiers` object[], required: The standard tiers, from the standard rate to the cheapest.
      - `tier` 'base' | 'silver' | 'gold', required
      - `creditsPerEntityPerRefresh` number, required: Credits charged per tracked company or person each time the list refreshes.
      - `description` string, required: When this tier applies.
    - `companyLists` object[], required: All non-archived company tracker lists with the tier their next refresh is billed at, and what would move each to a cheaper tier. May include paused lists.
      - `id` string, required: Tracker list ID.
      - `name` string, required: List name.
      - `entityType` 'company' | 'person', required: Entity type tracked by this list.
      - `refreshIntervalDays` integer, required: How often the list is checked, in days.
      - `tier` object, nullable: The tier the list's next scheduled refresh will be billed at, with its per-entity cost and when the tier applies. Null when your organization has a negotiated rate instead of the standard tiers.
        - `tier` 'base' | 'silver' | 'gold', required
        - `creditsPerEntityPerRefresh` number, required: Credits charged per tracked company or person each time the list refreshes.
        - `description` string, required: When this tier applies.
      - `criteria` object, required: The two criteria that decide the tier. The entity-count criterion is judged across ALL of your lists; the refresh-interval criterion is judged on this list alone.
        - `meetsEntityCountCriteria` boolean, required: True when your organization's tracked entity total meets the volume threshold described in the tiers table.
        - `meetsRefreshIntervalCriteria` boolean, required: True when this list refreshes at least once a day (refreshIntervalDays of 1 or less).
      - `hasPremiumRules` boolean, required: True when the list has at least one active premium rule. A list with one or more premium rules can never be billed higher than Silver — it cannot be on Gold, even when both criteria are met.
      - `toReachNextTier` union: The one change that would move this list to the next cheaper tier, and that tier's per-entity cost. Null when the list is already on Gold, when premium rules block the next tier, or when your organization has a negotiated rate.
        - object
          - `nextTier` 'base' | 'silver' | 'gold', required: The tier this change moves the list to.
          - `nextTierCreditsPerEntity` number, required: Credits charged per tracked company or person each time the list refreshes.
          - `advice` 'increase_refresh_cadence', required
          - `increaseTo` 'daily', required: The refresh cadence to switch this list to.
        - object
          - `nextTier` 'base' | 'silver' | 'gold', required: The tier this change moves the list to.
          - `nextTierCreditsPerEntity` number, required: Credits charged per tracked company or person each time the list refreshes.
          - `advice` 'add_more_entities', required
          - `needToAdd` integer, required: How many more companies and people your organization would need to track, across all lists, to meet the volume criterion. Always at least 1.
    - `personLists` object[], required: All non-archived person tracker lists with the tier their next refresh is billed at, and what would move each to a cheaper tier. May include paused lists.
      - `id` string, required: Tracker list ID.
      - `name` string, required: List name.
      - `entityType` 'company' | 'person', required: Entity type tracked by this list.
      - `refreshIntervalDays` integer, required: How often the list is checked, in days.
      - `tier` object, nullable: The tier the list's next scheduled refresh will be billed at, with its per-entity cost and when the tier applies. Null when your organization has a negotiated rate instead of the standard tiers.
        - `tier` 'base' | 'silver' | 'gold', required
        - `creditsPerEntityPerRefresh` number, required: Credits charged per tracked company or person each time the list refreshes.
        - `description` string, required: When this tier applies.
      - `criteria` object, required: The two criteria that decide the tier. The entity-count criterion is judged across ALL of your lists; the refresh-interval criterion is judged on this list alone.
        - `meetsEntityCountCriteria` boolean, required: True when your organization's tracked entity total meets the volume threshold described in the tiers table.
        - `meetsRefreshIntervalCriteria` boolean, required: True when this list refreshes at least once a day (refreshIntervalDays of 1 or less).
      - `hasPremiumRules` boolean, required: True when the list has at least one active premium rule. A list with one or more premium rules can never be billed higher than Silver — it cannot be on Gold, even when both criteria are met.
      - `toReachNextTier` union: The one change that would move this list to the next cheaper tier, and that tier's per-entity cost. Null when the list is already on Gold, when premium rules block the next tier, or when your organization has a negotiated rate.
        - object
          - `nextTier` 'base' | 'silver' | 'gold', required: The tier this change moves the list to.
          - `nextTierCreditsPerEntity` number, required: Credits charged per tracked company or person each time the list refreshes.
          - `advice` 'increase_refresh_cadence', required
          - `increaseTo` 'daily', required: The refresh cadence to switch this list to.
        - object
          - `nextTier` 'base' | 'silver' | 'gold', required: The tier this change moves the list to.
          - `nextTierCreditsPerEntity` number, required: Credits charged per tracked company or person each time the list refreshes.
          - `advice` 'add_more_entities', required
          - `needToAdd` integer, required: How many more companies and people your organization would need to track, across all lists, to meet the volume criterion. Always at least 1.
  - `chargeInfo` union, required
    - object: Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
  - `warnings` object[], nullable: Warnings about extraneous fields in request
    - `field` string, required: Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required: Warning message
  - `advice` string[], nullable: Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400`: Default Response
- `401`: Default Response
- `402`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: Default Response
- `429`: Default Response
- `500`: Default Response
- `503`: Default Response

## Changes

- **2026-10-27** `a15af2897f6b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fiber/apis/fiber-ai-api/changes/v1/tracker/pricing-tiers/get.md)

---

[API](https://skmtc.dev/fiber/apis/fiber-ai-api.md) - [All operations](https://skmtc.dev/fiber/apis/fiber-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fiber/apis/fiber-ai-api/revisions/02c72abf1918?raw)