Datasets
Board reports
The board of directors’ annual report, split into chapters: governance, pay, related parties, risks.
1,300+
Board reports
17
Standard chapter categories
EN · AR
Languages
Available from Starter+
Every Saudi listed company publishes a board of directors' report each year, alongside its financial statements. It's where the company explains its strategy and results, and discloses what the Capital Market Authority requires: who sits on the board, what they and senior executives are paid, related-party transactions, penalties, risks and dividend policy.
Q4 keeps each board report three ways:
- As chapters. List sections splits the report into its chapters, each tagged with a standard category. Retrieve a section returns one chapter's text, paragraph by paragraph with pages, and its tables.
- As figures. Every number in its tables, such as board pay, meeting attendance and related-party amounts, is in List figures with its page and position. Filter with
document_id. - As the whole text. Retrieve document text returns the full report as Markdown with page markers.
Following a topic across years
Because chapters share categories, you can line up the same disclosure year after year, whatever each report called it:
# Al Rajhi Bank's board and executive pay chapters since 2023
curl "https://api.q4.sa/v1/companies/1120/sections?category=remuneration&from_year=2023" \
-H "x-api-key: $Q4_API_KEY"Categories
| Category | What the chapter covers |
|---|---|
business_overview | Activities, subsidiaries and where the company operates |
strategy | Strategy, plans and outlook |
financial_highlights | Results, five-year summary and the explanation of material changes |
segments | Results by business line and geography |
board_composition | Board members, their classification (independent, non-executive) and other directorships |
board_meetings | Meetings held and attendance |
committees | Audit, remuneration, nomination and other committees: members, meetings, work |
remuneration | Pay of board members, committee members and senior executives |
governance | Compliance with the Corporate Governance Regulations, and any provisions not applied |
related_parties | Transactions and contracts in which a director or executive has an interest |
shareholders | Major shareholders, directors' and executives' holdings and changes in them |
dividend_policy | Dividend policy and dividends paid or proposed |
risks | Risks the company faces and how it manages them |
penalties | Penalties or sanctions imposed by regulators |
audit | External auditor, internal audit and internal controls |
sustainability | Social, environmental and community work |
other | Anything that doesn't fit the categories above |
Chapters that cover several topics are split into one section per category where the report allows, so each section is about one thing.
Endpoints
GET
/documents
List documents
Free
GET/documents/{id}/sections
List sections
Starter+
GET/documents/{id}/sections/{section_id}
Retrieve a section
Starter+
GET/companies/{symbol}/sections
Search board report sections
Starter+
GET/documents/{id}/text
Retrieve document text
Starter+
GET/companies/{symbol}/facts
List figures
Starter+
