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
Earnings calls

Retrieve an earnings call

GEThttps://api.q4.sa/v1/earnings-calls/{id}
Returns one call’s details, speakers and linked presentation.
Pro+

Authorization

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

Path parameters

idstringrequired
Earnings call ID, e.g. call_3Fn8xR.

Response

dataobject
The result.
idstring
Unique ID.
symbolstring
Tadawul symbol.
titlestring
Title.
fiscal_yearinteger
Fiscal year.
fiscal_periodstring
Fiscal period: FY, Q1–Q4, H1 or 9M.
held_atdatetime
languagestring
Language code.
duration_secondsinteger
Length of the recording.
speakersobject[]
idstring
Unique ID.
namestring
rolestring
presentation_idstring

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
List earnings calls
Next →
Retrieve a transcript
Request
curl "https://api.q4.sa/v1/earnings-calls/call_3Fn8xR" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "id": "call_3Fn8xR",
    "symbol": "2222",
    "title": "Q3 2026 earnings call",
    "fiscal_year": 2026,
    "fiscal_period": "Q3",
    "held_at": "2026-11-04T12:30:00Z",
    "language": "en",
    "duration_seconds": 3412,
    "speakers": [
      {
        "id": "spk_1",
        "name": "Chief Financial Officer",
        "role": "management"
      },
      {
        "id": "spk_2",
        "name": "Analyst",
        "role": "analyst"
      }
    ],
    "presentation_id": "doc_8Pd2xN"
  }
}