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"
}
'import requests
url = "https://api.heify.com/get-transcription"
payload = { "transcription_id": "e6b7d4ce-c63d-42df-86a8-c3fabe203b2a" }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({transcription_id: 'e6b7d4ce-c63d-42df-86a8-c3fabe203b2a'})
};
fetch('https://api.heify.com/get-transcription', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.heify.com/get-transcription",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'transcription_id' => 'e6b7d4ce-c63d-42df-86a8-c3fabe203b2a'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.heify.com/get-transcription"
payload := strings.NewReader("{\n \"transcription_id\": \"e6b7d4ce-c63d-42df-86a8-c3fabe203b2a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.heify.com/get-transcription")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"transcription_id\": \"e6b7d4ce-c63d-42df-86a8-c3fabe203b2a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.heify.com/get-transcription")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transcription_id\": \"e6b7d4ce-c63d-42df-86a8-c3fabe203b2a\"\n}"
response = http.request(request)
puts response.read_body{
"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
}
]
}
}
}
}
}Transcriptions
Get Transcription
Retrieve the full details of a single transcription, including conversation, summary, extracted fields, and evaluation breakdown.
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"
}
'import requests
url = "https://api.heify.com/get-transcription"
payload = { "transcription_id": "e6b7d4ce-c63d-42df-86a8-c3fabe203b2a" }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({transcription_id: 'e6b7d4ce-c63d-42df-86a8-c3fabe203b2a'})
};
fetch('https://api.heify.com/get-transcription', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.heify.com/get-transcription",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'transcription_id' => 'e6b7d4ce-c63d-42df-86a8-c3fabe203b2a'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.heify.com/get-transcription"
payload := strings.NewReader("{\n \"transcription_id\": \"e6b7d4ce-c63d-42df-86a8-c3fabe203b2a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.heify.com/get-transcription")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"transcription_id\": \"e6b7d4ce-c63d-42df-86a8-c3fabe203b2a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.heify.com/get-transcription")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transcription_id\": \"e6b7d4ce-c63d-42df-86a8-c3fabe203b2a\"\n}"
response = http.request(request)
puts response.read_body{
"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
Body
application/json
The unique identifier of the transcription to retrieve.
Response
200 - application/json
Transcription retrieved successfully. Response shape varies by status — see schema.
A completed transcription with full details.
- COMPLETED
- FAILED
- IN_PROGRESS
Show child attributes
Show child attributes
⌘I