# List Tickers

`GET` `/v1/transcripts/tickers`

List every ticker that has at least one earnings call transcript in Vantafin. Results are sorted alphabetically and paginated with cursor and limit (default 100, max 1000). Use search to narrow by ticker substring. Pair with List Transcripts to discover coverage before fetching call metadata or full text for a ticker.

## Use cases

- Discovering which companies have transcript coverage
- Building transcript-enabled universes or screeners
- Sync jobs that walk every covered ticker
- Coverage audits before launching transcript features

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `search` | string | No | Filter by ticker substring. |
| `cursor` | string | No | Return tickers strictly after this ticker (pagination). |
| `limit` | integer | No | Max results, 1-1000 (default 100). |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `results` | array | Tickers with transcript coverage on this page. |
| `results[]` | string | Ticker. |
| `count` | integer | Number of tickers on this page. |
| `next_cursor` | string | Pass as cursor on the next request; null when there is no further page. |

## Example response

```json
{
  "results": [
    "AAPL",
    "ABBV",
    "ABNB",
    "ADBE",
    "ADI"
  ],
  "count": 5,
  "next_cursor": "ADI"
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/transcripts/tickers?limit=100&apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

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

result = client.list_transcript_tickers(limit=100)

print(result)
```

### JavaScript

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

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

const result = await client.listTranscriptTickers({ limit: 100 });

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.ListTranscriptTickers(vantafin.Params{"limit": 100})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;
import com.vantafin.Params;

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

        Object result = client.listTranscriptTickers(Params.of().set("limit", 100));

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

### Ruby

```ruby
require "vantafin"

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

result = client.list_transcript_tickers(limit: 100)

pp result
```