# 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

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `ticker` | string | Yes | Ticker. |
| `page` | integer | No | Zero-based page (default 0). |
| `limit` | integer | No | Page size, 1-100 (default 20). |

## Output parameters

| Name | 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. |

## Example response

```json
{
  "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
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/transcripts/AAPL?apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.list_transcripts("AAPL")

print(result)
```

### JavaScript

```javascript
import { RestClient } from "vantafin";

const client = new RestClient("vf-live-your_api_key");

const result = await client.listTranscripts("AAPL");

console.log(result);
```

### Go

```go
package main

import (
	"fmt"
	"log"

	"github.com/vantafin/vantafin-go"
)

func main() {
	client := vantafin.NewClient("vf-live-your_api_key")

	result, err := client.ListTranscripts("AAPL")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;

public class Example {
    public static void main(String[] args) throws Exception {
        RestClient client = new RestClient("vf-live-your_api_key");

        Object result = client.listTranscripts("AAPL");

        System.out.println(result);
    }
}
```

### Ruby

```ruby
require "vantafin"

client = Vantafin::RestClient.new("vf-live-your_api_key")

result = client.list_transcripts("AAPL")

pp result
```