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 dividends

GEThttps://api.q4.sa/v1/companies/{symbol}/dividends
Returns announced and paid cash dividends, with eligibility and payment dates.
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

limitinteger
Results per page.
Default: 20 · Range: 1–100

Response

dataobject
The result.
symbolstring
Tadawul symbol.
trailing_12m_dividendsnumber
trailing_12m_yieldnumber
upcomingarray
historyobject[]
periodstring
dividend_per_sharenumber
total_amountinteger
announced_ondate
eligibility_datedate
distribution_datedate
announcement_idstring
Announcement that disclosed it.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
Compare companies
Next →
List corporate actions
Request
curl "https://api.q4.sa/v1/companies/2222/dividends" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "symbol": "2222",
    "trailing_12m_dividends": 1.26,
    "trailing_12m_yield": 0.0496,
    "upcoming": [],
    "history": [
      {
        "period": "Q2 2026",
        "dividend_per_share": 0.33,
        "total_amount": 79860000000,
        "announced_on": "2026-08-04",
        "eligibility_date": "2026-08-17",
        "distribution_date": "2026-08-31",
        "announcement_id": "ann_44Rt9w"
      }
    ]
  }
}