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 section

GEThttps://api.q4.sa/v1/documents/{id}/sections/{section_id}
Returns one board report chapter in full: its text paragraph by paragraph with pages, and its tables with the figures in them.
Starter+

Authorization

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

Path parameters

idstringrequired
Document ID, e.g. doc_7Hk2pQ.
section_idstringrequired
Section ID from List sections, e.g. sec_09.

Query parameters

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

Response

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

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
List sections
Next →
Search board report sections
Request
curl "https://api.q4.sa/v1/documents/doc_5Bn3Wd/sections/sec_09" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "document_id": "doc_5Bn3Wd",
    "id": "sec_09",
    "title": "Remuneration of Board members and Senior Executives",
    "category": "remuneration",
    "pages": [
      36,
      39
    ],
    "paragraphs": [
      {
        "page": 36,
        "text": "The Remuneration Policy for Board members, Committee members and Senior Executives was approved by the General Assembly…"
      },
      {
        "page": 37,
        "text": "The table below shows the remuneration paid to Board members for the year ended 31 December 2025…"
      }
    ],
    "tables": [
      {
        "title": "Remuneration of Board members (SAR)",
        "page": 37,
        "columns": [
          "Fixed remuneration",
          "Attendance allowance",
          "Variable remuneration",
          "Total"
        ],
        "rows": [
          {
            "label": "Independent members",
            "fact_ids": [
              "fct_6Hp2Ra",
              "fct_6Hp2Rb",
              "fct_6Hp2Rc",
              "fct_6Hp2Rd"
            ]
          }
        ]
      }
    ]
  }
}