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

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

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

## Request

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

Every issuance-relevant filing for the company, dated and cited — identical to the paid company page's timeline.

## Path parameters

- `ticker` string, required

## Response `200`

The timeline.

- object

## 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)