/api/data-points-for-component

GET

Retrieve the data points for a given component. A component can be selected in several ways, for example with an accession number (AID), section URI and hypercube name, or with a CIK, fiscal year, fiscal period, and disclosure, etc.

Parameters

Name Type Description Profile
profile-name query Specifies which profile to use, which will enable some parameters or modify hypercube queries accordingly. The default depends on the underlying repository  
format query Returns the results in the supplied format  
format-indent query Whether or not to indent JSON or XML output (default: no indent).  
token query The token that allows you to use this API. Gives you read (GET) and/or write (POST, DELETE, PATCH) credentials.  
aid query Archive IDs, to retrieve archives, sections, components or slice facts.  
eid query The EIDs (scheme + local name) of a company, to retrieve entities, archives, sections, components or dice facts.  
cik query The CIK of a company, to retrieve entities, archives, sections, components or dice facts. sec
ticker query The ticker of a company, to retrieve entities, archives, sections, components or dice facts. sec, japan
edinetcode query The EDINET code of a company, to retrieve entities, archives, sections, components or dice facts. japan
entity-tag query The tag of an entity (such as an index), to retrieve entities, archives, sections, components or dice facts. sec, japan
sic query The SIC (industry group) of a company, to retrieve entities, archives, sections, components or dice facts. sec
section query The URI of a particular section, to retrieve a section, component or report element.  
hypercube query The name of a hypercube report element, to retrieve components / sections.  
concept query The name of a concept to dice facts (a synonym for the dimension xbrl:Concept).  
fiscalYear query A fiscal year to slice facts (a synonym for the dimension xbrl28:FiscalYear, default: no filtering). sec, japan
fiscalPeriod query A fiscal period to slice facts (a synonym for the dimension xbrl28:FiscalPeriod, default: no filtering). sec, japan
fiscalPeriodType query A fiscal period type to slice facts (a synonym for the dimension xbrl28:FiscalPeriodType, default: no filtering). sec, japan
archiveFiscalYear query The fiscal year focus of the archive, to retrieve archives, sections, components or slice facts (default: ALL). sec, japan
archiveFiscalPeriod query The fiscal period focus of the archive, to retrieve archives, sections, components or slice facts (default: ALL). sec, japan
labels query Whether human-readable labels should be included for concepts in each fact (default: false).  
metadata query Whether metadata about the facts concept and dimensions should be included in each fact (default: false).  
open query Whether the hypercube query has open hypercube semantics, i.e., automatically stretches to accommodate for all found dimensions (default: false).  
prefix:dimension query The name of a dimension used for slicing and dicing facts. Accepted format: prefix:dimension. As a value, the value of the dimension or ALL can be provided if all facts with this dimension should be retrieved.  
prefix:dimension::category query Specifies whether the dimension is a slicer, a dicer, or unchanged. If an aggregation function is specified, facts are aggregated along slicers and grouped along dicers (default: unchanged).  
prefix:dimension::visible query Specifies whether the dimension is visible in the output. Only applies to dimensions defined as slicers. Default: false for slicers, but always true for dicers.  
prefix:dimension::slicer query [Deprecated] Specifies whether the dimension is a slicer (true) or not (false). Slicer dimensions do not appear in the output fact table, and if an aggregation function is specified, facts are aggregated along this dimension (default: false).  
archive-tag query The tag of the archive, to retrieve archives, sections, components or slice facts (default: no filtering). japan
disclosure query A disclosure, to identify sections or components (e.g. BalanceSheet). sec, japan
reportElement query The name of the report element to search for, to retrieve a section, a component or a report element (e.g. us-gaap:Goodwill).  
label query A search term to search in the labels of components, to retrieve components (e.g. stock).  
merge query Whether to merge components if multiple components are retrieved. By default, it is true. If false, a random component is selected if multiple are retrieved (default: true).  
language query A language code (default: en-US) for displaying labels.  
override query Whether the static component or report hypercube should be tampered with using the same hypercube-building API as the facts endpoint (default: true if a profile is active, otherwise automatically activated).  
count query If true, only outputs statistics (default: false).  
top query Output only the first [top] results (default: no limit).  
skip query Skip the first [skip] results.  

Status codes

Code Description
200 Return the data points for the given component
401 Unauthorized: the specified project token is invalid, expired, or has insufficient privileges
404 No such entity could be found. / No such archive could be found. / No such component could be found
500 An internal error occurred during the processing of the request