# Filing by ID

`GET` `/v1/filings/by-id/{filing_id}`

Fetch metadata for a single SEC filing using its Vantafin filing id (from the Filings by Ticker list or search). Returns form type, filing and report dates, CIK, ticker, primary document and URLs to the archived filing. Use this when you already have a filing id and need canonical metadata before pulling chunked content or linking to the EDGAR source.

## Use cases

- Deep-linking to a specific filing from search results
- Hydrating filing cards in a research UI
- Pipeline steps that resolve id → metadata before text extraction
- Audit trails that reference a stable Vantafin filing id

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `filing_id` | string | Yes | Vantafin filing id. |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `id` | string | Vantafin filing id. |
| `form` | string | SEC form type. |
| `filedAt` | string | Filing timestamp (ISO 8601). |
| `reportDate` | string | Period of report (YYYY-MM-DD). |
| `accessionNumber` | string | SEC accession number. |
| `cik` | string | Company CIK. |
| `ticker` | string | Ticker. |
| `primaryDocument` | string | Primary document filename. |
| `url` | string | URL to the filing on SEC EDGAR. |

## Example response

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

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/filings/by-id/0000320193-24-000123?apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

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

result = client.get_filing("0000320193-24-000123")

print(result)
```

### JavaScript

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

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

const result = await client.getFiling("0000320193-24-000123");

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.GetFiling("0000320193-24-000123")
	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.getFiling("0000320193-24-000123");

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

### Ruby

```ruby
require "vantafin"

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

result = client.get_filing("0000320193-24-000123")

pp result
```