curl --request GET \
--url https://api.finosu.com/calls/{id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.finosu.com/calls/{id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.finosu.com/calls/{id}', 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.finosu.com/calls/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.finosu.com/calls/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.finosu.com/calls/{id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.finosu.com/calls/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"customerId": "<string>",
"toPhoneNumber": "+14155551234",
"transcript": "<string>",
"recordingUrl": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"flags": [
"CONNECT",
"LIVE_CONNECT",
"RPC",
"MESSAGE_LEFT"
],
"summarization": "<string>"
}{
"error": 123,
"message": "<string>"
}Get Call by ID
Returns a specific call in the authenticated company. recordingUrl is a fresh one-hour link or null if unavailable. Missing, deleted, or inaccessible calls return 404.
curl --request GET \
--url https://api.finosu.com/calls/{id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.finosu.com/calls/{id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.finosu.com/calls/{id}', 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.finosu.com/calls/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.finosu.com/calls/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.finosu.com/calls/{id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.finosu.com/calls/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"customerId": "<string>",
"toPhoneNumber": "+14155551234",
"transcript": "<string>",
"recordingUrl": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"flags": [
"CONNECT",
"LIVE_CONNECT",
"RPC",
"MESSAGE_LEFT"
],
"summarization": "<string>"
}{
"error": 123,
"message": "<string>"
}404. recordingUrl is a fresh link valid for one hour, or null when no recording is available.Authorizations
Path Parameters
ID of call to retrieve
Response
Call response
ID of the customer
Phone number that was called (E.164 format)
"+14155551234"
Transcript of the call
S3 presigned URL for the call recording. Note: This URL expires after 1 hour.
Timestamp when the call occurred (ISO 8601 format)
Array of post-processing flags indicating call outcomes and events. Common flags include: NO_ANSWER, VOICEMAIL, CONNECT, LIVE_CONNECT, VOICEMAIL_CONNECT, AUTO_SYSTEM_CONNECT, MESSAGE_LEFT, RPC (Right Party Contact), THIRD_PARTY_CONTACT, WRONG_NUMBER, CUSTOMER_HANGUP, DNC (Do Not Call), COMPLAINT, THREAT_OR_ABUSE, DECEASED, INCARCERATED, MILITARY, BANKRUPTCY, HARDSHIP_REQUEST, DEBT_DISPUTE, ATTORNEY_REP, FRAUD_CLAIM, ACCESSIBILITY_ISSUE, CALLBACK_REQUEST, TRANSFER_FAILED, VOICEMAIL_FULL, VOICEMAIL_NOT_SET_UP, CIP_PASSED, CIP_FAILED, CIP_PARTIAL, CIP_REFUSED, SUCCESSFUL_TRANSFER, FALLBACK_TRANSFER, and others
[
"CONNECT",
"LIVE_CONNECT",
"RPC",
"MESSAGE_LEFT"
]
AI-generated summary of the call conversation and outcomes