Skip to main content
POST
/
get-transcription
Get Transcription
curl --request POST \
  --url https://api.heify.com/get-transcription \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "transcription_id": "e6b7d4ce-c63d-42df-86a8-c3fabe203b2a"
}
'
{
  "data": {
    "transcription_id": "e6b7d4ce-c63d-42df-86a8-c3fabe203b2a",
    "status": "COMPLETED",
    "configuration_id": "3b8006ad-b1a2-464b-9a6b-79dcd45c9433",
    "configuration_tag": "Pitch Analysis DEMO",
    "name": null,
    "group": null,
    "duration": 542.82,
    "participant_id": null,
    "evaluator_id": "2abb5563-dd64-47bb-bb17-94252e168b06",
    "participant_tag": null,
    "evaluator_tag": "pitch temporal",
    "details": {
      "language": "en",
      "num_speakers": 4,
      "created_at": "2026-03-21T11:22:30.211193+00:00",
      "completed_at": "2026-03-21T11:22:59.737279+00:00",
      "conversation": {
        "segments": [
          {
            "text": "Hi, Sharks. My name is Charlie Green. I'm from Los Angeles, California, and I'm here seeking $300,000 for 5% equity in my company, Ramento.",
            "speaker": "SPEAKER_00"
          },
          {
            "text": "So, what does it cost to do this project?",
            "speaker": "SPEAKER_01"
          }
        ]
      },
      "summary": null,
      "fields": {
        "fields": [
          {
            "name": "requested_amount",
            "value": 300000
          },
          {
            "name": "deal_accepted",
            "value": true
          },
          {
            "name": "product_name",
            "value": "Ramento"
          },
          {
            "name": "reported_profit",
            "value": null
          }
        ]
      },
      "evaluation": {
        "score": 52.8,
        "critical_fail": false,
        "status": "COMPLETED",
        "breakdown": {
          "evaluator_id": "2abb5563-dd64-47bb-bb17-94252e168b06",
          "evaluator_tag": "pitch temporal",
          "generated_at": "2026-03-21T11:22:59.601049+00:00",
          "language_used": "es",
          "final_score": 52.8,
          "critical_fail_triggered": false,
          "summary_feedback": "### Visión General\n\nEl pitch ha obtenido una calificación de 52.8/100...",
          "results": [
            {
              "criteria_id": "2faa4a20-7445-4beb-a09e-2af26872dba3",
              "name": "Saludo Corporativo inicial",
              "type": "boolean",
              "max_weight": 34,
              "score_raw_ai": 0,
              "score_obtained": 0,
              "status": "FAIL",
              "reasoning": "El pitch no comienza con la presentación formal requerida.",
              "quote": "Hi, Sharks. My name is Charlie Green...",
              "feedback": "Es fundamental iniciar el pitch con una presentación clara y formal."
            },
            {
              "criteria_id": "5718a64e-43e6-4959-90a6-19946b44249c",
              "name": "Escucha Activa",
              "type": "scale",
              "max_weight": 33,
              "score_raw_ai": 4,
              "score_obtained": 26.4,
              "status": "PASS",
              "reasoning": "El emprendedor demuestra buena escucha activa.",
              "quote": "That's exactly the way the product is designed today.",
              "feedback": null
            }
          ]
        }
      }
    }
  }
}
For the full Transcription data model, see Transcription.
The response structure varies by status. See Transcription status.
summary, fields, and conversation are null if those features were not enabled in the Configuration used for this transcription.
Returns 404 if the transcription is not found.
For the evaluation breakdown structure and criterion types (boolean, scale, strict), see Evaluator.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
transcription_id
string<uuid>
required

The unique identifier of the transcription to retrieve.

Response

200 - application/json

Transcription retrieved successfully. Response shape varies by status — see schema.

​
data
COMPLETED · object

A completed transcription with full details.