---
title: "Cross-company values for one XBRL concept and period"
method: GET
path: "/sec/frames"
tags: ["SEC EDGAR"]
---

# Cross-company values for one XBRL concept and period

`GET /sec/frames`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sec/frames`
- Auth: API key in header `x-api-key`

Returns every filer's reported value for one XBRL concept in one reporting period (an EDGAR "frame").

## Query parameters

- `concept` string, required
- `period` string, required
- `unit` string
- `taxonomy` 'dei' | 'ifrs-full' | 'srt' | 'us-gaap'
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SecFramesResponseDoc
  - `code` integer
  - `data` SecFramesResponse
    - `concept` string: XBRL concept tag that was queried, such as `Assets`.
    - `count` integer: Number of facts returned.
    - `facts` SecFrameFact[]: One reported value per company for the concept and frame.
      - `accession_number` string: SEC accession number of the filing that reported the value.
      - `cik` integer: Reporting company's SEC Central Index Key (CIK) number.
      - `end` string: Last day of the period the value covers, in YYYY-MM-DD format.
      - `entity_name` string: Name of the reporting company.
      - `form` string: SEC form type of the filing that reported the value.
      - `start` string: First day of the period the value covers, in YYYY-MM-DD format.
      - `value` number: Value the company reported for the concept, in the unit given by `unit`.
    - `period` string: Reporting frame that was queried, such as `CY2024Q4I`.
    - `source_url` string: URL the data was read from.
    - `taxonomy` string: XBRL taxonomy the concept belongs to, such as `us-gaap`.
    - `total` integer: Number of companies that reported the concept for the frame.
    - `unit` string: Unit of the reported values, such as `USD`.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

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