# Filings by Ticker

`GET` `/v1/filings/{ticker}`

List SEC EDGAR filings for a company by ticker. Optionally filter by form type (10-K, 10-Q, 8-K, etc.) using a comma-separated form parameter. Returns filing metadata - form, filing date, accession number and Vantafin filing id - with pagination via page and limit. Use the filing id with the Filing by ID endpoint or Vantafin’s filing viewer for full text.

## Use cases

- Building a filing history tab on a company profile
- Finding the latest 10-K or 10-Q for a ticker
- Compliance workflows that track periodic reports
- Feeding filing ids into document search or download pipelines

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `ticker` | string | Yes | Ticker. |
| `form` | string | No | Form filter, e.g. 10-K or 10-K,10-Q,8-K. |
| `page` | integer | No | Zero-based page (default 0). |
| `limit` | integer | No | Page size, 1-2000 (default 50). |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `ticker` | string | Ticker requested. |
| `cik` | string | Company CIK. |
| `results` | array | Filing metadata rows for this page. |
| `results[].id` | string | Vantafin filing id. |
| `results[].form` | string | SEC form type (e.g. 10-K, 10-Q). |
| `results[].filedAt` | string | Filing timestamp (ISO 8601). |
| `results[].reportDate` | string | Period of report (YYYY-MM-DD). |
| `results[].accessionNumber` | string | SEC accession number. |
| `results[].primaryDocument` | string | Primary document filename. |
| `total` | integer | Total filings matching the query. |
| `page` | integer | Zero-based page index. |

## Example response

```json
{
  "ticker": "AAPL",
  "cik": "0000320193",
  "results": [
    {
      "cik": "0000320193",
      "ticker": "AAPL",
      "company": "Apple Inc.",
      "form": "10-Q",
      "date": "2026-05-01T10:01:00Z",
      "accession": "0000320193-26-000013",
      "edgar_base": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013",
      "exhibits": [
        {
          "type": "10-Q",
          "sequence": 1,
          "filename": "aapl-20260328.htm",
          "description": "10-Q",
          "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013/aapl-20260328.htm",
          "minio_key": "320193/000032019326000013/aapl-20260328.htm"
        },
        {
          "type": "EX-31.1",
          "sequence": 2,
          "filename": "a10-qexhibit31103282026.htm",
          "description": "EX-31.1",
          "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013/a10-qexhibit31103282026.htm",
          "minio_key": "320193/000032019326000013/a10-qexhibit31103282026.htm"
        }
      ],
      "id": "0000320193_000032019326000013"
    },
    {
      "cik": "0000320193",
      "ticker": "AAPL",
      "company": "Apple Inc.",
      "form": "10-Q",
      "date": "2026-01-30T11:01:32Z",
      "accession": "0000320193-26-000006",
      "edgar_base": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000006",
      "exhibits": [
        {
          "type": "10-Q",
          "sequence": 1,
          "filename": "aapl-20251227.htm",
          "description": "10-Q",
          "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000006/aapl-20251227.htm",
          "minio_key": "320193/000032019326000006/aapl-20251227.htm"
        },
        {
          "type": "EX-31.1",
          "sequence": 2,
          "filename": "a10-qexhibit31112272025.htm",
          "description": "EX-31.1",
          "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000006/a10-qexhibit31112272025.htm",
          "minio_key": "320193/000032019326000006/a10-qexhibit31112272025.htm"
        }
      ],
      "id": "0000320193_000032019326000006"
    }
  ],
  "total": 26,
  "page": 0
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/filings/AAPL?form=10-K,10-Q&apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

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

result = client.get_filings("AAPL", form="10-K,10-Q")

print(result)
```

### JavaScript

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

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

const result = await client.getFilings("AAPL", { form: "10-K,10-Q" });

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.GetFilings("AAPL", vantafin.Params{"form": "10-K,10-Q"})
	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.getFilings("AAPL", Params.of().set("form", "10-K,10-Q"));

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

### Ruby

```ruby
require "vantafin"

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

result = client.get_filings("AAPL", form: "10-K,10-Q")

pp result
```