Retrieve call audio
Return the audio recording of one earnings call: the file metadata plus a
signed url on content.roic.ai that you download without API credentials.
The link is valid until expires_at, one hour after the request; call the
route again for a fresh one. Send the URL exactly as returned, because its
filename and verify arguments are part of the signature and any change
answers 403.
Take the audio_ id from the audio array of the
call listing. Audio requires a Professional
or Enterprise plan.
/v3.0.0/documents/audio/{id}Plan Access
Free
(Your plan)
Individual
$29/mo
Professional
$89/mo
Plan History
Free
(Your plan)
Not included
Individual
$29/mo
Not included
Professional
$89/mo
All available
curl "https://api.roic.ai/v3.0.0/documents/audio/audio_7Ft0XPWQVpVeJ1?apikey=YOUR_API_KEY"{
"id": "audio_7Ft0XPWQVpVeJ1",
"event": "evt_hbBlbCUawzMoz0",
"symbol": "NASDAQ:AAPL",
"fiscal_year": 2026,
"fiscal_quarter": 3,
"period_end_date": "2026-06-30",
"filename": "NASDAQ-AAPL_earnings-call_2026-06-30_FY2026-Q3_audio_7Ft0XPWQVpVeJ1.mp3",
"url": "https://content.roic.ai/audio/audio_7Ft0XPWQVpVeJ1.mp3?filename=NASDAQ-AAPL_earnings-call_2026-06-30_FY2026-Q3_audio_7Ft0XPWQVpVeJ1.mp3&verify=1758031446-<mac>",
"expires_at": "2026-09-16T14:04:06.885Z",
"document_group": "audio",
"document_kind": "earnings_call",
"language": "en",
"created_at": "2026-07-31T02:14:52.118Z",
"updated_at": "2026-07-31T02:31:07.442Z"
}Parameters
Path parameters
idstringrequiredThe audio id from the audio array of the event listing, beginning with audio_.
audio_7Ft0XPWQVpVeJ1Response
Response fields
idstringUnique identifier for the file. doc_ for a slide deck or a filing.
eventstringIdentifier of the parent event, beginning with evt_.
symbolstringQualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL. It names the primary listing of the event.
fiscal_yearnumberFiscal year the event reports on, e.g. 2026. The fiscal year is the calendar year in which it ends. null when the period is not known.
fiscal_quarternumberFiscal quarter the event reports on, from 1 to 4. null for an annual period and when the quarter is not known. If the company reports semiannually, the first half is 2 and the second half is 4.
period_end_datestringLast day of the reporting period, in YYYY-MM-DD format.
filenamestringDownload name of the file. The fiscal label appears only when the period is certain, and the language code only when the file is not in English.
urlstringSigned download link on content.roic.ai. Fetch it directly, without API credentials, and send it exactly as returned.
expires_atstringISO 8601 timestamp after which url stops working, one hour after the request by default. Call the route again for a new link.
document_groupstringAlways audio: the recording is the call itself, not one of the document groups.
document_kindstringAlways earnings_call: the recording is the call itself.
languagestringTwo-letter language code of the file, e.g. en. null when it is not known.
created_atstringISO 8601 UTC timestamp of when this file was first stored.
updated_atstringISO 8601 UTC timestamp of when this file last changed.
Errors
| Status | code | When it happens |
|---|---|---|
| 400 | invalid_parameter | A malformed id. |
| 402 | document_restricted | The key is below the Professional plan. |
| 404 | resource_missing | No recording with that id. |