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

Search board report sections

GEThttps://api.q4.sa/v1/companies/{symbol}/sections
Returns the same board report chapter across years, e.g. directors’ remuneration since 2020.
Starter+

Authorization

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

Path parameters

symbolstringrequired
Tadawul symbol, e.g. 2222 for Saudi Aramco. ISINs are accepted too.

Query parameters

categorystring (comma-separated)
Comma-separated standard categories, e.g. remuneration.
qstring
Words in the chapter title or text, e.g. penalties or audit committee.
from_yearinteger
First fiscal year.
to_yearinteger
Last fiscal year.
limitinteger
Results per page.
Default: 20 · Range: 1–100
cursorstring
The next_cursor from the previous page. Omit it for the first page.

Response

dataobject[]
The result.
document_idstring
Document the item came from.
fiscal_yearinteger
Fiscal year.
idstring
Unique ID.
titlestring
Title.
categorystring
pagesinteger[]
Page count.
snippetstring
The start of the chapter, or where the search words appear.
paginationobject
Paging details. See Pagination.
next_cursorstring
Pass as cursor to get the next page. null on the last page.
limitinteger
Page size used.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
Retrieve a section
Next →
List earnings calls
Request
curl "https://api.q4.sa/v1/companies/1120/sections?category=remuneration&from_year=2023" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": [
    {
      "document_id": "doc_5Bn3Wd",
      "fiscal_year": 2025,
      "id": "sec_09",
      "title": "Remuneration of Board members and Senior Executives",
      "category": "remuneration",
      "pages": [
        36,
        39
      ],
      "snippet": "The table below shows the remuneration paid to Board members…"
    },
    {
      "document_id": "doc_2Kc7Vy",
      "fiscal_year": 2024,
      "id": "sec_08",
      "title": "Remuneration of Board members and Senior Executives",
      "category": "remuneration",
      "pages": [
        34,
        37
      ],
      "snippet": "The table below shows the remuneration paid to Board members…"
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6MTIwfQ",
    "limit": 50
  }
}