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

List sections

GEThttps://api.q4.sa/v1/documents/{id}/sections
Lists the chapters of a board report, in order, each tagged with a standard category.
Starter+

Board reports follow the Capital Market Authority’s disclosure rules, so they cover the same ground every year, in each company’s own words and order. Every chapter is tagged with a standard category, so remuneration is the directors’ pay chapter whatever the company called it.

Read a chapter in full with Retrieve a section.

Authorization

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

Path parameters

idstringrequired
ID of a board report (type=board_report).

Query parameters

categorystring (comma-separated)
Only these categories, comma-separated, e.g. remuneration,related_parties.

Response

dataobject[]
The result.
idstring
Section ID, unique within the document.
titlestring
The chapter title as printed.
categorystring
Standard category. See the list on the Board reports page.
pagesinteger[]
First and last page of the chapter.
tablesinteger
Tables in the chapter.
figuresinteger
Figures in those tables, available from List figures.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
Retrieve a note
Next →
Retrieve a section
Request
curl "https://api.q4.sa/v1/documents/doc_5Bn3Wd/sections" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": [
    {
      "id": "sec_01",
      "title": "Overview of the Bank’s activities",
      "category": "business_overview",
      "pages": [
        4,
        9
      ],
      "tables": 1,
      "figures": 14
    },
    {
      "id": "sec_06",
      "title": "Board of Directors and its committees",
      "category": "board_composition",
      "pages": [
        22,
        31
      ],
      "tables": 4,
      "figures": 38
    },
    {
      "id": "sec_09",
      "title": "Remuneration of Board members and Senior Executives",
      "category": "remuneration",
      "pages": [
        36,
        39
      ],
      "tables": 3,
      "figures": 62
    },
    {
      "id": "sec_12",
      "title": "Transactions with related parties",
      "category": "related_parties",
      "pages": [
        44,
        46
      ],
      "tables": 1,
      "figures": 21
    }
  ]
}