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

List stock events

GEThttps://api.q4.sa/v1/events
A single feed of results, dividends, AGMs, capital changes and other material events.
Pro+

Authorization

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

Query parameters

symbolsstring (comma-separated)
Comma-separated Tadawul symbols. Matches any of them.
typesstring (comma-separated)
Comma-separated, e.g. financial_results,dividend,general_assembly.
fromdate
Start date, inclusive (YYYY-MM-DD).
todate
End date, inclusive (YYYY-MM-DD).
updated_afterdatetime
Only items created or changed after this time. Use it to sync incrementally.
limitinteger
Results per page.
Default: 50 · Range: 1–500
cursorstring
The next_cursor from the previous page. Omit it for the first page.

Response

dataobject[]
The result.
idstring
Unique ID.
symbolstring
Tadawul symbol.
typestring
Type.
datedate
Trading date (Riyadh).
titlestring
Title.
announcement_idstring
Announcement that disclosed it.
document_idstring
Document the item came from.
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 corporate actions
Next →
Search notes
Request
curl "https://api.q4.sa/v1/events?symbols=2222&types=financial_results,dividend" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": [
    {
      "id": "evt_7Gq1Ns",
      "symbol": "2222",
      "type": "financial_results",
      "date": "2026-11-03",
      "title": "Q3 2026 interim results",
      "announcement_id": "ann_51Vb3k",
      "document_id": "doc_8Pd2xM"
    },
    {
      "id": "evt_7Gq1Nt",
      "symbol": "2222",
      "type": "dividend",
      "date": "2026-11-03",
      "title": "Q3 2026 cash dividend of SAR 0.33 per share",
      "announcement_id": "ann_51Vb3m",
      "document_id": null
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6MTIwfQ",
    "limit": 50
  }
}