SEC EDGAR · Schema

SEC EDGAR XBRL Fact Value

Schema for a single XBRL fact value as returned in companyfacts and companyconcept endpoint responses

Financial DataSECEDGARPublic Company FilingsXBRLRegulatoryGovernmentFinancial ReportingCompany SubmissionsSecurities

Properties

Name	Type	Description
start	string	Period start date for duration concepts (e.g., income statement items). Absent for instant/point-in-time concepts.
end	string	Period end date for duration concepts, or instant date for balance sheet concepts.
val	object	The reported value. Typically a number for financial concepts, but may be a string for non-numeric concepts.
accn	string	Accession number of the EDGAR filing that reported this value.
fy	integer	Fiscal year associated with this fact.
fp	string	Fiscal period code.
form	string	Form type of the filing reporting this value.
filed	string	Date the filing was accepted by EDGAR.
frame	string	Calendar period frame reference for use with the /api/xbrl/frames/ endpoint. Present only when the value aligns to a standard calendar period.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/sec/main/json-schema/sec-xbrl-fact-value.json",
  "title": "SEC EDGAR XBRL Fact Value",
  "description": "Schema for a single XBRL fact value as returned in companyfacts and companyconcept endpoint responses",
  "type": "object",
  "required": ["end", "val", "accn", "form", "filed"],
  "properties": {
    "start": {
      "type": "string",
      "format": "date",
      "description": "Period start date for duration concepts (e.g., income statement items). Absent for instant/point-in-time concepts.",
      "examples": ["2022-09-25"]
    },
    "end": {
      "type": "string",
      "format": "date",
      "description": "Period end date for duration concepts, or instant date for balance sheet concepts.",
      "examples": ["2023-09-30"]
    },
    "val": {
      "description": "The reported value. Typically a number for financial concepts, but may be a string for non-numeric concepts.",
      "oneOf": [
        { "type": "number" },
        { "type": "string" }
      ],
      "examples": [62611000000]
    },
    "accn": {
      "type": "string",
      "description": "Accession number of the EDGAR filing that reported this value.",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "examples": ["0000320193-23-000106"]
    },
    "fy": {
      "type": "integer",
      "description": "Fiscal year associated with this fact.",
      "examples": [2023]
    },
    "fp": {
      "type": "string",
      "description": "Fiscal period code.",
      "enum": ["FY", "Q1", "Q2", "Q3", "Q4"],
      "examples": ["FY"]
    },
    "form": {
      "type": "string",
      "description": "Form type of the filing reporting this value.",
      "examples": ["10-K", "10-Q"]
    },
    "filed": {
      "type": "string",
      "format": "date",
      "description": "Date the filing was accepted by EDGAR.",
      "examples": ["2023-11-03"]
    },
    "frame": {
      "type": "string",
      "description": "Calendar period frame reference for use with the /api/xbrl/frames/ endpoint. Present only when the value aligns to a standard calendar period.",
      "pattern": "^CY\\d{4}(Q[1-4]I?)?$",
      "examples": ["CY2023Q3I", "CY2023"]
    }
  }
}