Q4API Docs
Q4 APISign inGet API key
DocumentationAPI Reference
Overview
API reference
Companies
GETList companiesGETRetrieve a companyGETList sectors
Market data
GETRetrieve a quoteGETList quotesGETRetrieve price historyGETRetrieve index historyGETRetrieve market summaryGETList market moversGETList sector performanceGETList tradesGETRetrieve order book depth
WebSocket
WSQuotes streamWSTrades streamWSDepth stream
Fundamentals
GETRetrieve standardised statementsGETRetrieve as-reported statementsGETList figuresGETRetrieve ratiosGETCompare companiesGETList dividendsGETList corporate actionsGETList stock eventsGETSearch notes
Documents
GETList documentsGETRetrieve a documentGETList document pagesGETRetrieve document textGETRetrieve document summaryGETList notesGETRetrieve a noteGETList sectionsGETRetrieve a sectionGETSearch board report sections
Earnings calls
GETList earnings callsGETRetrieve an earnings callGETRetrieve a transcriptGETRetrieve call audio
Announcements
GETList announcementsGETRetrieve an announcement
Economic data
GETList seriesGETList observations
Webhooks & alerts
POSTCreate a webhookGETList webhooksDELDelete a webhookPOSTCreate an alert ruleGETList alert rulesDELDelete an alert rule
Account
GETRetrieve usage
Fundamentals

Retrieve as-reported statements

GEThttps://api.q4.sa/v1/companies/{symbol}/financials/as-reported
Returns a financial statement exactly as the company printed it: every line, in order, with its subtotals and note references.
Starter+

Nothing is renamed, merged or dropped. Rows keep the company’s own labels, order and indentation, and every cell links to its printed figure with fact_id.

When a row cites a note, note holds the note number: pass it to Retrieve a note to read the footnote behind the line.

By default the statement comes from the latest filing for the period, so restated comparatives show their restated values. Pass document_id to see a specific filing as published.

Authorization

x-api-keyheaderrequired
Your API key. See Authentication.

Path parameters

symbolstringrequired
Tadawul symbol, e.g. 2222 for Saudi Aramco. ISINs are accepted too.

Query parameters

statementstringrequired
Which statement.
One of:incomecomprehensive_incomebalancechanges_in_equitycash_flow
fiscal_yearinteger
Fiscal year. Defaults to the latest.
fiscal_periodstring
Annual or interim statement.
One of:FYQ1Q2Q3Q4
Default: FY
document_idstring
Use this filing instead of the latest one for the period.
languagestring
The English or Arabic version of the filing.
One of:enar
Default: en
include_unverifiedboolean
Include cells we could not read with confidence. They come back with verified: false.
Default: false

Response

dataobject
The result.
symbolstring
Tadawul symbol.
statementstring
titlestring
The statement title as printed.
document_idstring
Document the item came from.
pageinteger
Page the statement starts on.
currencystring
ISO currency code.
scalestring
The scale printed on the statement. cells[].value already has it applied.
columnsobject[]
The columns as printed, usually the current period and the comparative.
keystring
Key of this column in each row’s cells.
labelstring
Line item label as printed.
fiscal_yearinteger
Fiscal year.
period_enddate
Last day of the period.
rowsobject[]
Every line of the statement, in printed order.
lineinteger
Position in the statement.
labelstring
The line label as printed.
depthinteger
Indentation level as printed: 0 for totals, 1 and deeper for the lines under them.
kindstring
heading, item, subtotal or total.
notestring
The note number printed beside the line, if any. Read it with Retrieve a note.
cellsobject
One cell per column key.
c1object
valueinteger
Value.
printedstring
The value as printed, brackets included.
fact_idstring
The printed figure this value came from.
verifiedboolean
False if we could not read the value with confidence.
c2object
valueinteger
Value.
printedstring
fact_idstring
The printed figure this value came from.
verifiedboolean

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
Retrieve standardised statements
Next →
List figures
Request
curl "https://api.q4.sa/v1/companies/1120/financials/as-reported?statement=income&fiscal_year=2025" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "symbol": "1120",
    "statement": "income",
    "title": "CONSOLIDATED STATEMENT OF INCOME",
    "document_id": "doc_7Hk2pQ",
    "page": 14,
    "currency": "SAR",
    "scale": "thousands",
    "columns": [
      {
        "key": "c1",
        "label": "2025",
        "fiscal_year": 2025,
        "period_end": "2025-12-31"
      },
      {
        "key": "c2",
        "label": "2024",
        "fiscal_year": 2024,
        "period_end": "2024-12-31"
      }
    ],
    "rows": [
      {
        "line": 1,
        "label": "Income from investments and financing",
        "depth": 1,
        "kind": "item",
        "note": "24",
        "cells": {
          "c1": {
            "value": 52118402000,
            "printed": "52,118,402",
            "fact_id": "fct_9Qm2La",
            "verified": true
          },
          "c2": {
            "value": 47390118000,
            "printed": "47,390,118",
            "fact_id": "fct_7Tz1Ka",
            "verified": true
          }
        }
      },
      {
        "line": 2,
        "label": "Return on deposits and financial liabilities",
        "depth": 1,
        "kind": "item",
        "note": "24",
        "cells": {
          "c1": {
            "value": -21664870000,
            "printed": "(21,664,870)",
            "fact_id": "fct_9Qm2Lb",
            "verified": true
          },
          "c2": {
            "value": -19882305000,
            "printed": "(19,882,305)",
            "fact_id": "fct_7Tz1Kb",
            "verified": true
          }
        }
      },
      {
        "line": 3,
        "label": "Income from investments and financing, net",
        "depth": 0,
        "kind": "subtotal",
        "note": null,
        "cells": {
          "c1": {
            "value": 30453532000,
            "printed": "30,453,532",
            "fact_id": "fct_9Qm2Lc",
            "verified": true
          },
          "c2": {
            "value": 27507813000,
            "printed": "27,507,813",
            "fact_id": "fct_7Tz1Kc",
            "verified": true
          }
        }
      },
      {
        "line": 18,
        "label": "Net income for the year",
        "depth": 0,
        "kind": "total",
        "note": null,
        "cells": {
          "c1": {
            "value": 21802045000,
            "printed": "21,802,045",
            "fact_id": "fct_9Qm2Lx",
            "verified": true
          },
          "c2": {
            "value": 18480112000,
            "printed": "18,480,112",
            "fact_id": "fct_7Tz1Kx",
            "verified": true
          }
        }
      }
    ]
  }
}