---
title: "The share-issuance timeline for one company, as CSV (paid)"
method: GET
path: "/api/v1/company/{ticker}/timeline.csv"
---

# The share-issuance timeline for one company, as CSV (paid)

`GET /api/v1/company/{ticker}/timeline.csv`

## Request

- Base URL: `https://dilutionlens.com`
- URL: `https://dilutionlens.com/api/v1/company/{ticker}/timeline.csv`
- Auth: API key in header `x-api-key`

The rows of /api/v1/company/{ticker}/timeline, serialised as CSV. Columns are that endpoint's own JSON field names, one row per filing. The timeline itself is capped at the 200 most recent issuance filings, so a company with a longer history exports those 200 and not its whole record — the JSON endpoint and the website's own table carry exactly the same 200. Content-Disposition names the file <TICKER>-timeline-<YYYY-MM-DD>.csv. Per-ticker only.

## Path parameters

- `ticker` string, required

## Response `200`

The CSV file. An empty body means the company has no rows on record.

## Other responses

- `400`: Unknown ticker, unknown section, or a bulk-shaped request (error code per_ticker_only, answered with the professional contact address).
- `401`: Missing, unknown or revoked API key. The body carries an error code (auth_required | invalid_key).
- `402`: This endpoint is part of a paid plan (error code unlock_required). Plans: https://dilutionlens.com/pricing/
- `429`: The shared per-account budget (or the free daily cap) is spent. Hourly budgets reset at the top of the hour; the free cap resets at midnight UTC.

---

[API](https://skmtc.dev/dilutionlens/apis/dilutionlens-api.md) · [All operations](https://skmtc.dev/dilutionlens/apis/dilutionlens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dilutionlens/apis/dilutionlens-api/revisions/8c5ffcc17c43?raw)