List Transcripts
GET/v1/transcripts/{ticker}
List available earnings call transcripts for a ticker. Each entry includes transcript id, fiscal period, fiscal year, call date and company name - use the transcript id with Get Transcript to download the full text. Paginate with page and limit (default 20, max 100).
Use cases
- Earnings call libraries on company pages
- Finding the latest or prior-quarter transcript id
- Building a timeline of management commentary
- Selecting calls for NLP or sentiment analysis
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | Ticker. |
| page | integer | Zero-based page (default 0). |
| limit | integer | Page size, 1-100 (default 20). |
Output parameters
| Field | Type | Description |
|---|---|---|
| results | array | Available transcripts for this page. |
| results[].id | string | Transcript id for the get endpoint. |
| results[].ticker | string | Ticker. |
| results[].quarter | string | Fiscal quarter label (e.g. Q4). |
| results[].year | integer | Fiscal year. |
| results[].date | string | Call date (YYYY-MM-DD). |
| results[].title | string | Transcript title. |
| count | integer | Number of rows on this page. |
| total | integer | Total transcripts available. |
| page | integer | Zero-based page index. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.list_transcripts("AAPL")
print(result){
"transcripts": [
{
"id": "AAPL_2026_Q2",
"period": "Q2",
"fiscal_year": 2026,
"date": "2026-04-30",
"company": "Apple Inc."
},
{
"id": "AAPL_2026_Q1",
"period": "Q1",
"fiscal_year": 2026,
"date": "2026-01-29",
"company": "Apple Inc."
}
],
"total": 83
}