---
title: "Estimate enrichment cost"
method: POST
path: "/v1/audiences/{audienceId}/enrichment/estimate"
tags: ["Audiences"]
---

# Estimate enrichment cost

`POST /v1/audiences/{audienceId}/enrichment/estimate`

## Request

- Base URL: `https://api.fiber.ai`
- URL: `https://api.fiber.ai/v1/audiences/{audienceId}/enrichment/estimate`
- Auth: none declared

Estimates the credit cost for an audience enrichment run before triggering it. Returns detailed breakdown by operation type (Sales Navigator, live enrichment, contact enrichment, validation) and estimated completion time. This endpoint is free and does not charge any credits.

<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>

## Path parameters

- `audienceId` string, required

## Request body

- object
  - `apiKey` string, required: Your Fiber API key
  - `maxProspectsToEnrich` integer, required: Maximum number of prospects to include when estimating enrichment cost (must be a positive integer; very large values may be rejected by internal safety limits).
  - `enrichmentType` object, required: Enrichment types to estimate costs for
    - `getWorkEmails` boolean
    - `getPersonalEmails` boolean
    - `getPhoneNumbers` boolean
  - `runCompanyLiveEnrichment` boolean: Whether to include company live enrichment in estimate
  - `runProfileLiveEnrichment` boolean: Whether to include profile live enrichment in estimate
  - `runProfileSalesNav` boolean: Whether to include Sales Navigator enrichment in estimate
  - `runContactEnrichment` boolean: Whether to include contact enrichment in estimate

## Response `200`

Default Response

- object
  - `output` object, required
    - `totalCredits` number, required: The total estimated credits required.
    - `breakdown` object, required: The detailed cost breakdown by operation type.
      - `salesNav` object, required: Sales Navigator enrichment cost
        - `credits` number, required
        - `isFree` boolean, required
      - `liveCompany` object, required: Company live enrichment cost
        - `credits` number, required
        - `discounted` boolean, required
      - `liveProspect` object, required: Prospect live enrichment cost
        - `credits` number, required
        - `discounted` boolean, required
      - `waterfall` object, required: Waterfall pricing for contact enrichment
        - `credits` number, required
        - `originalCredits` number, required
        - `discount` number, required
        - `operations` object, required
          - `workEmail` number, required
          - `personalEmail` number, required
          - `phone` number, required
      - `validation` object, required: Email validation cost
        - `credits` number, required
        - `isFree` boolean, required
    - `timeEstimate` object, required: The estimated time to complete enrichment.
      - `totalSeconds` number, required
      - `formatted` string, required
  - `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-07-31** `4002aa81d4fb`: 2 breaking, 1 info
  - the response property `advice` became nullable for the status `200`
  - the response property `advice` became optional for the status `200`
  - the `advice` response's property default value `` was removed for the status `200`
- **2026-07-13** `f14ac2efab0c`: 2 info
  - added the non-success response with the status `422`
  - added the required property `advice` to the response with the `200` status

[Operation history](https://skmtc.dev/fiber/apis/fiber-ai-api/changes/v1/audiences/:audienceId/enrichment/estimate/post.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/d8237cb5c35e?raw)