Q4API Docs
Q4 APISign inGet API key
DocumentationAPI Reference
Overview
IntroductionQuickstartData overviewPlans and limits
Datasets
CompaniesMarket dataRealtime & streamingFundamentalsDividends & corporate actionsFilings & reportsBoard reportsPresentationsEarnings callsAnnouncementsEconomic data
REST API
AuthenticationPagination and filteringRate limitsErrors
WebSocket
ConnectingStreamsWebSocket errors
Webhooks
WebhooksWebhook eventsSignatures
MCP
Q4 MCP connector
More
ChangelogSupport
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

CategoryWhat the chapter covers
business_overviewActivities, subsidiaries and where the company operates
strategyStrategy, plans and outlook
financial_highlightsResults, five-year summary and the explanation of material changes
segmentsResults by business line and geography
board_compositionBoard members, their classification (independent, non-executive) and other directorships
board_meetingsMeetings held and attendance
committeesAudit, remuneration, nomination and other committees: members, meetings, work
remunerationPay of board members, committee members and senior executives
governanceCompliance with the Corporate Governance Regulations, and any provisions not applied
related_partiesTransactions and contracts in which a director or executive has an interest
shareholdersMajor shareholders, directors' and executives' holdings and changes in them
dividend_policyDividend policy and dividends paid or proposed
risksRisks the company faces and how it manages them
penaltiesPenalties or sanctions imposed by regulators
auditExternal auditor, internal audit and internal controls
sustainabilitySocial, environmental and community work
otherAnything 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+
← Previous
Filings & reports
Next →
Presentations
On this page
Following a topic across yearsCategoriesEndpoints