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

# Estimate enrichment cost

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

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

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/versions/0c537984b99f/schema)