---
title: "Extract details from call transcripts"
method: POST
path: "/extract_details"
tags: ["Extraction"]
---

# Extract details from call transcripts

`POST /extract_details`

Given a recording URL, a transcript, some background information, and a list of field configurations, this endpoint will:

return a dictionary of extracted details according to the provided `fields_config`.

## Request body

- ExtractDetailsRequest — Defines the request body for the `/extract_details` endpoint. Attributes: recording_url: The URL to an audio recording of the call that will be transcribed by Whisper. call_transcript: Pre-existing transcript from agent orchestration platform (like Retell or VAPI). background_info: Additional context or background about the call or business that might guide extraction. fields_config: A list of FieldConfig objects describing what data to extract from the call transcripts.
  - `recording_url` string, required — URL to the audio file of the call.
  - `call_transcript` string, required — A string representing transcript of the call.
  - `background_info` string, required — Additional context that helps guide what should be extracted from the transcript (e.g. information about the business).
  - `fields_config` FieldConfig[], required — List of field configuration objects specifying what to extract from the transcript.
    - `name` string, required — The unique name of this field to be extracted (e.g., 'email', 'phone', 'summary').
    - `description` string, required — A human-readable description of what this field contains (e.g., 'The caller's email address').
    - `examples` string[], nullable — Optional example values for this field to guide the extraction.
    - `instructions_for_extraction` string, nullable — Additional instructions or constraints about how to extract this field from the transcript.
    - `type` 'string' | 'boolean' — The JSON data type for this field. Currently, only 'string' or 'boolean' are supported.
    - `required` boolean — Indicates if this field is mandatory in the extracted results.

## Response `200`

A dictionary containing extracted field values.

- object

## Other responses

- `422` — Validation Error

## Changes

- **2025-03-19** `e73c3ee8a697` — 1 breaking, 1 warning
  - added the new required request property `call_transcript`
  - removed the request property `retell_transcript`
- **2025-03-19** `77937a18bc4c` — 1 breaking, 1 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - api tag `Extraction` added

[Change history](https://skmtc.dev/metavoiceio/apis/metavoice-postcall-api/changes/extract_details/post.md)

---

[API](https://skmtc.dev/metavoiceio/apis/metavoice-postcall-api.md) · [All operations](https://skmtc.dev/metavoiceio/apis/metavoice-postcall-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/metavoiceio/metavoice-postcall-api/revisions/e73c3ee8a697/schema)