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 corporate actions

GEThttps://api.q4.sa/v1/companies/{symbol}/corporate-actions
Returns rights issues, bonus shares, capital changes, buybacks and splits.
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

typestring (comma-separated)
Comma-separated: rights_issue, bonus_shares, capital_increase, capital_reduction, share_buyback, stock_split.

Response

dataobject[]
The result.
idstring
Unique ID.
typestring
Type.
stagestring
ratiostring
shares_beforeinteger
shares_afterinteger
capital_beforeinteger
capital_afterinteger
announced_ondate
effective_datedate
announcement_idstring
Announcement that disclosed it.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
List dividends
Next →
List stock events
Request
curl "https://api.q4.sa/v1/companies/2222/corporate-actions" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": [
    {
      "id": "act_2Lw8Pz",
      "type": "bonus_shares",
      "stage": "completed",
      "ratio": "1 for 10",
      "shares_before": 220000000000,
      "shares_after": 242000000000,
      "capital_before": 75000000000,
      "capital_after": 75000000000,
      "announced_on": "2023-03-12",
      "effective_date": "2023-05-14",
      "announcement_id": "ann_19Kp2c"
    }
  ]
}