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
Documents

Retrieve document summary

GEThttps://api.q4.sa/v1/documents/{id}/summary
Returns an AI summary of the document, each point cited to its page.
Starter+

Authorization

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

Path parameters

idstringrequired
Document ID, e.g. doc_7Hk2pQ.

Query parameters

lengthstring
One line, a paragraph, or a full brief.
One of:lineshortlong
Default: short
languagestring
Summary language.
One of:enar
Default: en

Response

dataobject
The result.
idstring
Unique ID.
lengthstring
languagestring
Language code.
summarystring
Short summary.
citationsobject[]
textstring
pageinteger
generated_atdatetime

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
Retrieve document text
Next →
List notes
Request
curl "https://api.q4.sa/v1/documents/doc_7Hk2pQ/summary?length=short" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "id": "doc_7Hk2pQ",
    "length": "short",
    "language": "en",
    "summary": "Net income rose 18% to SAR 21.8bn on higher financing income…",
    "citations": [
      {
        "text": "Net income rose 18% to SAR 21.8bn",
        "page": 14
      }
    ],
    "generated_at": "2026-02-18T06:10:02Z"
  }
}