---
title: "Filer XBRL facts"
method: GET
path: "/api/v2/filings/{cik}/facts"
tags: ["Filings"]
---

# Filer XBRL facts

`GET /api/v2/filings/{cik}/facts`

XBRL structured financial facts for a filer — a concept time series for exposure sizing. Requires a plan with SEC filings access (`can_use_filings`) — the Corporate & Supply Chain plan and above.

## Path parameters

- `cik` integer, required

## Query parameters

- `concept` string
- `taxonomy` string
- `limit` integer
- `cursor` string

## Response `200`

A page of XBRL facts, by concept then period_end. Each row: concept, taxonomy, unit, period_end, fp (fiscal period, or null), fy (fiscal year, or null), value, form_type (or null), filed_date, accession_no. Envelope: { success, cik, data, pagination, applied_filters }.

- object
  - `success` boolean
  - `cik` integer
  - `data` object[]
    - `concept` string
    - `taxonomy` string
    - `unit` string
    - `period_end` string
    - `fp` string
    - `fy` integer
    - `value` integer
    - `form_type` string
    - `filed_date` string
    - `accession_no` string
  - `pagination` object
    - `limit` integer
    - `cursor` unknown
    - `next_cursor` unknown
  - `applied_filters` object
    - `cik` integer
    - `concept` string
    - `ignored` object

## Other responses

- `401` — Missing/invalid API key
- `403` — Plan required (PLAN_REQUIRED)
- `500` — Server error

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)