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
Companies

Retrieve a company

GEThttps://api.q4.sa/v1/companies/{symbol}
Returns one company’s profile, shares and listing details.
FreeValuation fields (market_cap, pe_ratio, pb_ratio) need 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.

Response

dataobject
The result.
symbolstring
Tadawul symbol.
isinstring
International Securities Identification Number.
name_enstring
Name in English.
name_arstring
Name in Arabic.
marketstring
main (TASI) or nomu.
sectorstring
Sector slug.
industrystring
statusstring
Current status.
listed_ondate
issued_sharesinteger
Shares in issue.
currencystring
ISO currency code.
fiscal_year_endstring
websitestring
descriptionstring
market_capinteger
Market capitalisation, SAR.
pe_rationumber
Price to trailing earnings.
pb_rationumber
Price to book value.
updated_atdatetime
When this record last changed.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
List companies
Next →
List sectors
Request
curl "https://api.q4.sa/v1/companies/2222" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "symbol": "2222",
    "isin": "SA14TG012N13",
    "name_en": "Saudi Arabian Oil Co.",
    "name_ar": "أرامكو السعودية",
    "market": "main",
    "sector": "energy",
    "industry": "Oil & Gas Integrated",
    "status": "active",
    "listed_on": "2019-12-11",
    "issued_shares": 242000000000,
    "currency": "SAR",
    "fiscal_year_end": "12-31",
    "website": "https://www.aramco.com",
    "description": "Integrated energy and chemicals company…",
    "market_cap": 6151640000000,
    "pe_ratio": 16.8,
    "pb_ratio": 4.1,
    "updated_at": "2026-11-03T13:35:00Z"
  }
}