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
Documents

Retrieve a note

GEThttps://api.q4.sa/v1/documents/{id}/notes/{number}
Returns one note’s full text, its tables, and the figures in them.
Starter+

The text is the note as printed, split into paragraphs with the page each comes from, so you can quote an accounting policy or a contingency and cite it. Tables come back as rows of labels and the figure IDs in each cell.

Authorization

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

Path parameters

idstringrequired
Document ID, e.g. doc_7Hk2pQ.
numberstringrequired
Note number as printed, e.g. 27.

Query parameters

formatstring
Paragraphs with pages, one Markdown block, or plain text.
One of:paragraphsmarkdownplain
Default: paragraphs
include_tablesboolean
Include the note’s tables.
Default: true

Response

dataobject
The result.
document_idstring
Document the item came from.
numberstring
titlestring
Title.
pagesinteger[]
Page count.
paragraphsobject[]
The note’s text, in order.
pageinteger
Page the paragraph is printed on.
textstring
tablesobject[]
Tables in the note.
titlestring
Title.
pageinteger
columnsstring[]
rowsobject[]
labelstring
Line item label as printed.
fact_idsstring[]
One figure ID per column. Fetch them with List figures, or match on id.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
List notes
Next →
List sections
Request
curl "https://api.q4.sa/v1/documents/doc_7Hk2pQ/notes/27" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "document_id": "doc_7Hk2pQ",
    "number": "27",
    "title": "SEGMENT INFORMATION",
    "pages": [
      70,
      72
    ],
    "paragraphs": [
      {
        "page": 70,
        "text": "Operating segments are identified on the basis of internal reports about components of the Group that are regularly reviewed by the Board of Directors…"
      },
      {
        "page": 70,
        "text": "The Group’s primary business is conducted in the Kingdom of Saudi Arabia. The Group has four reportable segments: Retail, Corporate, Treasury and Investment services and brokerage…"
      }
    ],
    "tables": [
      {
        "title": "Segment information for the year ended 31 December 2025",
        "page": 71,
        "columns": [
          "Retail",
          "Corporate",
          "Treasury",
          "Investment services",
          "Total"
        ],
        "rows": [
          {
            "label": "Net income for the year",
            "fact_ids": [
              "fct_4Rb8Tn",
              "fct_4Rb8Tp",
              "fct_4Rb8Tq",
              "fct_4Rb8Tr",
              "fct_4Rb8Ts"
            ]
          }
        ]
      }
    ]
  }
}