Read a single XBRL financial concept for a company (by CIK or ticker) from its a
Read a single XBRL financial concept for a company (by CIK or ticker) from its as-filed statements. Give the concept's XBRL tag (e.g. Revenues, NetIncomeLoss, Assets, EarningsPerShareDiluted) and optionally the taxonomy (default us-gaap, also dei). Returns the label and, per unit (USD, shares), recent datapoints with period end, value, fiscal year/period, form, filing date and accession. Bounded, as-reported output.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://edgar.openverbs.com/v1/facts
| Category | Company and compliance |
|---|---|
| Provider host | edgar.openverbs.com |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 5 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
We never call tools that send, buy, move money or file anything, not even without paying.
Example input (from the provider)
{
"body": {
"cik": "example",
"concept": "example",
"ticker": "example"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"cik": {
"description": "Central Index Key (1-10 digits). Provide this or `ticker`.",
"maxLength": 10,
"minLength": 1,
"type": "string"
},
"concept": {
"description": "XBRL concept tag, e.g. \"Revenues\", \"NetIncomeLoss\", \"Assets\".",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"limit": {
"default": 8,
"description": "Max datapoints per unit, most recent first (default 8).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"taxonomy": {
"default": "us-gaap",
"description": "XBRL taxonomy, usually \"us-gaap\" (also \"dei\", \"ifrs-full\").",
"maxLength": 20,
"minLength": 1,
"type": "string"
},
"ticker": {
"description": "Ticker symbol, e.g. \"AAPL\". Provide this or `cik`.",
"maxLength": 10,
"minLength": 1,
"type": "string"
}
},
"required": [
"concept"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}