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
Fundamentals

Search notes

GEThttps://api.q4.sa/v1/companies/{symbol}/notes
Finds notes across all of a company’s financial reports by title or text, e.g. every segment note 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

qstring
Words in the note title or text, e.g. zakat, related parties, expected credit loss.
fiscal_yearinteger
Only notes in reports for this fiscal year.
fiscal_periodstring
Only notes in reports for this period.
One of:FYQ1Q2Q3Q4
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.
fiscal_periodstring
Fiscal period: FY, Q1–Q4, H1 or 9M.
numberstring
titlestring
Title.
pagesinteger[]
Page count.
snippetstring
Where the search words appear in the note.
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
List stock events
Next →
List documents
Request
curl "https://api.q4.sa/v1/companies/1120/notes?q=zakat" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": [
    {
      "document_id": "doc_7Hk2pQ",
      "fiscal_year": 2025,
      "fiscal_period": "FY",
      "number": "30",
      "title": "ZAKAT",
      "pages": [
        76,
        77
      ],
      "snippet": "…the Bank has filed its Zakat returns with the Zakat, Tax and Customs Authority up to the year ended 31 December 2024…"
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6MTIwfQ",
    "limit": 50
  }
}