schema_files

Explore SEC and FASB XBRL taxonomy schemas, labels, and presentation structures.

• No parameters: list all available taxonomy families.
• taxonomy only: get all parsed structures for the most recent year.
• taxonomy + year: get all parsed structures for a specific year.
• taxonomy + component: get one component's structure using the most recent year.
• taxonomy + year + component: get one component's parsed structure.

Examples

from openbb import obb
obb.sec.schema_files(provider='sec')
# Explore XBRL taxonomies progressively.
# List all available taxonomy families
obb.sec.schema_files(provider='sec')
# List components for US GAAP (latest year)
obb.sec.schema_files(taxonomy='us-gaap', provider='sec')
# List presentation components for US GAAP 2024
obb.sec.schema_files(taxonomy='us-gaap', year=2024, provider='sec')
# Get the Statement of Income presentation structure
obb.sec.schema_files(taxonomy='us-gaap', year=2024, component='soi', provider='sec')

Parameters

• standard
• sec

taxonomy: str | None
Taxonomy family to explore. Omit to list all available taxonomies and their descriptions.

year: int | None
Taxonomy year (e.g. 2011+ for us-gaap, varies by taxonomy). Defaults to the most recent year when omitted.

component: str | None
Presentation component to retrieve. Values are taxonomy-specific. Omit to return all components for the taxonomy.

category: str | None
Filter taxonomies by SEC filer category.

---

Returns

results: SchemaFiles

Serializable results.

provider: str | None

Provider name.

warnings: Optional[list[Warning_]]

List of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• sec

name: str
Identifier: taxonomy key, year, component name, or XBRL element ID depending on the query mode.

label: str | None
Human-readable label.

description: str | None
Description or long name.

category: str | None
Taxonomy category (e.g., operating_company).

style: str | None
Taxonomy style (e.g., FASB_STANDARD, SEC_EMBEDDED).

has_label_linkbase: bool | None
Whether the taxonomy has a parseable label linkbase.

url: str | None
URL to the taxonomy resource or SEC reference page.

level: int | None
Hierarchy depth in presentation structure (0 = root).

order: float | None
Sort order within parent in presentation structure.

parent_id: str | None
Parent XBRL element ID in presentation structure.

preferred_label: str | None
Preferred label role URI for presentation rendering.

xbrl_type: str | None
XBRL data type (e.g., monetaryItemType, textBlockItemType, stringItemType, sharesItemType, perShareItemType, domainItemType).

period_type: str | None
Period type: 'instant' (point-in-time) or 'duration' (over a period).

balance_type: str | None
Balance type for monetary items: 'credit' or 'debit'.

abstract: bool | None
Whether the element is abstract (grouping/heading only, not taggable).

substitution_group: str | None
XBRL substitution group: 'item' (line item), 'dimensionItem' (axis), 'hypercubeItem' (table).

nillable: bool | None
Whether the element value can be nil.