company.financial_research · v1 · financial
SEC Financial Research Brief
Available
Two adjacent annual periods of a public operating issuer’s US GAAP USD financial facts, filing citations, comparative changes and clearly labeled derived measures. This is public-source financial research, not a proprietary Altss Company Dossier.
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"cik"
],
"additionalProperties": false,
"properties": {
"cik": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "Exact ten-digit nonzero SEC CIK."
}
}
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"schemaVersion": {
"type": "number",
"const": 1
},
"kind": {
"type": "string",
"const": "SEC_FINANCIAL_RESEARCH"
},
"issuer": {
"type": "object",
"properties": {
"cik": {
"type": "string",
"pattern": "^\\d{10}$"
},
"reportedName": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"sic": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 1000
},
{
"type": "null"
}
]
},
"industry": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 1000
},
{
"type": "null"
}
]
},
"fiscalYearEnd": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 1000
},
{
"type": "null"
}
]
}
},
"required": [
"cik",
"reportedName",
"sic",
"industry",
"fiscalYearEnd"
],
"additionalProperties": false
},
"financialEntityName": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"laterFiledFactsExcluded": {
"type": "boolean"
},
"periods": {
"minItems": 2,
"maxItems": 2,
"type": "array",
"items": {
"type": "object",
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"filed": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"accession": {
"type": "string",
"pattern": "^\\d{10}-\\d{2}-\\d{6}$"
},
"filingUrl": {
"type": "string",
"format": "uri"
},
"facts": {
"minItems": 4,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"metric": {
"type": "string",
"enum": [
"revenue",
"netIncome",
"assets",
"operatingCashFlow",
"operatingIncome",
"grossProfit",
"liabilities",
"stockholdersEquity",
"cash",
"capitalExpenditure"
]
},
"concept": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"taxonomy": {
"type": "string",
"const": "us-gaap"
},
"unit": {
"type": "string",
"const": "USD"
},
"value": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"start": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"filed": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"accession": {
"type": "string",
"pattern": "^\\d{10}-\\d{2}-\\d{6}$"
},
"form": {
"type": "string",
"enum": [
"10-K",
"10-K/A"
]
}
},
"required": [
"metric",
"concept",
"taxonomy",
"unit",
"value",
"start",
"end",
"filed",
"accession",
"form"
],
"additionalProperties": false
}
},
"derived": {
"type": "object",
"properties": {
"netMarginPercent": {
"type": [
"number",
"null"
]
},
"operatingCashFlowMarginPercent": {
"type": [
"number",
"null"
]
},
"liabilitiesToAssetsPercent": {
"type": [
"number",
"null"
]
},
"operatingCashFlowLessPpePurchasesUsd": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"netMarginPercent",
"operatingCashFlowMarginPercent",
"liabilitiesToAssetsPercent",
"operatingCashFlowLessPpePurchasesUsd"
],
"additionalProperties": false
},
"missingMetrics": {
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"enum": [
"revenue",
"netIncome",
"assets",
"operatingCashFlow",
"operatingIncome",
"grossProfit",
"liabilities",
"stockholdersEquity",
"cash",
"capitalExpenditure"
]
}
}
},
"required": [
"start",
"end",
"filed",
"accession",
"filingUrl",
"facts",
"derived",
"missingMetrics"
],
"additionalProperties": false
}
},
"comparisons": {
"type": "object",
"properties": {
"priorPeriodEnd": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"currentPeriodEnd": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"revenueChangeUsd": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"revenueGrowthPercent": {
"type": "number"
},
"netIncomeChangeUsd": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"operatingCashFlowChangeUsd": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"priorPeriodEnd",
"currentPeriodEnd",
"revenueChangeUsd",
"revenueGrowthPercent",
"netIncomeChangeUsd",
"operatingCashFlowChangeUsd"
],
"additionalProperties": false
},
"methodology": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"taxonomy": {
"type": "string",
"const": "us-gaap"
},
"annualForms": {
"minItems": 2,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"10-K",
"10-K/A"
]
}
},
"cohortSelection": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"revenueConcept": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"periodLabels": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"cashFlowMeasure": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"required": [
"currency",
"taxonomy",
"annualForms",
"cohortSelection",
"revenueConcept",
"periodLabels",
"cashFlowMeasure"
],
"additionalProperties": false
},
"limitations": {
"minItems": 4,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"source": {
"type": "object",
"properties": {
"submissions": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"fetchedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"responseSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"url",
"fetchedAt",
"responseSha256"
],
"additionalProperties": false
},
"companyfacts": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"fetchedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"responseSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"url",
"fetchedAt",
"responseSha256"
],
"additionalProperties": false
}
},
"required": [
"submissions",
"companyfacts"
],
"additionalProperties": false
}
},
"required": [
"schemaVersion",
"kind",
"issuer",
"financialEntityName",
"laterFiledFactsExcluded",
"periods",
"comparisons",
"methodology",
"limitations",
"source"
],
"additionalProperties": false
}