GuidesAPI Reference
Guides

Example Flow

This page sets out an example of the calls made for a standard Trint API use case (synchronous upload followed by polling of the export API). It lists each call using cURL though other formats are available (see individual API specification for details). The API Key header has been redacted, but should be supplied in the format "API_Key:API_Secret".

Get list of transcribed files (before any files uploaded)
curl --request GET --url https://api.trint.com/transcripts/?limit=10&skip=0 -u "[REDACTED]" --header 'accept: application/json'

Response:

[]

Upload

curl -X POST 'https://upload.trint.com/?filename=TestFile' -u "[REDACTED]" -H 'content-type: video/mp4' --data-binary @MediaFile.mp4

Response:

{"trintId":"[TRINT_ID]"}

Export

curl --request GET --url 'https://api.trint.com/export/webvtt/[TRINT ID]' -u "[REDACTED]" --header 'accept: application/json'

Response:
"Not Found" (404 status, transcription not available yet)


Export

curl --request GET --url 'https://api.trint.com/export/webvtt/[TRINT ID]' -u "[REDACTED]" --header 'accept: application/json'

Response:

{"title":"TestFile","url":"[signed URL to download TestFile.vtt file]"}

Get list of transcribed files

curl --request GET --url https://api.trint.com/transcripts/?limit=10&skip=0 -u "[REDACTED]" --header 'accept: application/json'

Response:

[
  {
    "id": "[TRINT_ID]",
    "title": "TestFile",
    "metadata": "",
    "excerpt": "",
    "fileType": "TRANSCRIPT",
    "workspaceId": null,
    "folderId": null,
    "language": "en-US",
    "duration": 3600144,
    "timecode": "00:00:00.000",
    "timecodeOffsetEnabled": false,
    "notes": "",
    "updated": "2026-05-06T13:52:36.742Z",
    "created": "2026-05-06T13:44:29.416Z"
  }
]

Updated 3 days ago