---
title: "Filings, insider disclosures, aliases and legal-entity relationships."
method: GET
path: "/api/v1/research/{ticker}"
---

# Filings, insider disclosures, aliases and legal-entity relationships.

`GET /api/v1/research/{ticker}`

## Request

- Base URL: `https://tickerfacts.com`
- URL: `https://tickerfacts.com/api/v1/research/{ticker}`
- Auth: one of:
  - none
  - HTTP bearer

## Path parameters

- `ticker` string, required

## Response `200`

Research record with source licenses and coverage dates.

- CompanyResearch
  - `cik` integer, required
  - `company` CompanyResearchRecord, required
    - `entity_status` string, nullable, required
    - `filings` object[], required
      - `accession` string, required
      - `document` string, required
      - `filed` string, required
      - `form` string, required
      - `items` string, required
      - `report_date` string, required
    - `former_names` object[], required
      - `from` string, required
      - `name` string, required
      - `to` string, required
    - `gleif_parents` Parent[], required
      - `id` string, required
      - `name` string, required
      - `relationship` string, required
      - `source` string, required
      - `url` string, required
    - `headquarters` object[], required
      - `latitude` number, required
      - `longitude` number, required
      - `name` string, required
      - `precision` string, required
      - `source` string, required
      - `url` string, required
    - `insiders` object[], required
      - `accession` string, required
      - `acquired_disposed` string, required
      - `code` string, required
      - `date` string, required
      - `derivative` boolean, required
      - `filed` string, required
      - `following_shares` string, nullable, required: Decimal string, as reported.
      - `form` string, required
      - `owners` string[], required
      - `plan_10b5_1` boolean, required
      - `price` string, nullable, required: Decimal string, as reported.
      - `security` string, required
      - `shares` string, nullable, required: Decimal string, as reported.
    - `legal_name` string, nullable, required
    - `lei` string, nullable, required
    - `lei_status` string, nullable, required
    - `lei_updated_at` string, nullable, required
    - `names` object[], required
      - `entity_id` string, nullable, required
      - `kind` string, required
      - `name` string, required
      - `source` string, required
    - `parent_exceptions` string[], required
    - `parents` Parent[], required
      - `id` string, required
      - `name` string, required
      - `relationship` string, required
      - `source` string, required
      - `url` string, required
    - `wikidata_id` string, nullable, required
  - `research_built_at` string, required
  - `reviewed_events` ReviewedPassage[], required
    - `accounting_series_reconciled` boolean
    - `captured_at` string
    - `cik` integer, required
    - `end_char` integer
    - `event_date` string, required
    - `id` string, required
    - `interpretation` string
    - `normalized_text_sha256` string
    - `quote` string, required
    - `quote_sha256` string
    - `section` string, required
    - `source_sha256` string
    - `source_url` string, required
    - `start_char` integer
    - `ticker` string, required
    - `title` string, required
    - `verification` string
    - `verified_at` string, required
  - `reviewed_events_coverage` string, required
  - `sources` Source[], required
    - `coverage` string, required
    - `id` string, required
    - `license` string, required
    - `license_url` string, required
    - `name` string, required
    - `retrieved_at` string, required
    - `status` string, required: ok, stale or unavailable.
    - `url` string, required

## Other responses

- `404`: No such record in this build.

---

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