---
title: "Quote an interview"
method: POST
path: "/api/v1/interview-quotes"
tags: ["Interviews"]
---

# Quote an interview

`POST /api/v1/interview-quotes`

## Request

- Base URL: `https://app.probbai.com`
- URL: `https://app.probbai.com/api/v1/interview-quotes`
- Auth: HTTP bearer

Check the assigned configuration and applicable price before inviting a candidate. The returned fingerprint binds the invitation details to the quote you reviewed.

## Before you call

Use a report with a usable completed analysis, candidateEmail, and sendEmail. Resolve mismatch review in the app first.

**Required scope:** `interviews:write`.

## What happens next

Pass fingerprint as quoteFingerprint with the same report, email, and delivery choice to Invite a candidate. A quote sends no email and reserves no capacity.

## Recovery

An unfinished or unusable analysis cannot be quoted for interview. Requote if the invitation details or assigned configuration change. Example prices are illustrative.

[Follow the complete workflow](/integration-interviews/) · [Errors and retries](/api-errors/)

## Request body

- InterviewQuoteInput
  - `reportId` string, required: Report ID returned by upload preparation, admission, discovery, or an event. It must belong to the API key's workspace.
  - `candidateEmail` string, email, required: Email address of the intended candidate. The quote and invitation must use the same address.
  - `sendEmail` boolean: True (default) asks ProBB AI to email the invitation. False returns a private link credential for your system to deliver. Invitation batches require true.

## Response `200`

Pass fingerprint as quoteFingerprint with the same report, email, and delivery choice to Invite a candidate. A quote sends no email and reserves no capacity.

- object
  - `data` InterviewQuote, required
    - `reportId` string, required: Report ID returned by upload preparation, admission, discovery, or an event. It must belong to the API key's workspace.
    - `creditUnits` integer, required: Applicable price in integer units for the assigned configuration. This is a quote, not a reservation; example prices are illustrative.
    - `creditScale` integer, required: Number of integer units per displayed credit. Divide creditUnits by this value; use the scale returned by the API.
    - `fingerprint` string, required: Opaque quote fingerprint. Copy it unchanged into quoteFingerprint on the corresponding submission.
    - `interviewSystemVersion` string, required: Assigned interview version captured for this quote or attempt. Existing attempts retain their version.

## Other responses

- `400`: Invalid input or cursor
- `401`: Invalid, expired, or revoked API key
- `403`: Disabled organisation or missing scope
- `404`: The resource is absent, expired, deleted, or unavailable in this workspace. Verify the resource ID and key's workspace.
- `405`: Method not allowed; consult Allow for supported methods
- `409`: An unfinished or unusable analysis cannot be quoted for interview. Requote if the invitation details or assigned configuration change. Example prices are illustrative.
- `429`: Request limit exceeded
- `500`: Unexpected failure
- `503`: Service unavailable

---

[API](https://skmtc.dev/probbai/apis/probb-ai-customer-api.md) · [All operations](https://skmtc.dev/probbai/apis/probb-ai-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/probbai/apis/probb-ai-customer-api/revisions/33a3294530e4?raw)