API product catalogCorporate Actions & Shareholder Governance

Dividend history for a symbol

Corporate Actions & Shareholder Governance

GET

/dividends/{symbol}/history

Sandbox availablegetDividendHistory

Returns the full dividend declaration history for a specific stock symbol, ordered by ex-dividend date descending (most recent first).

Parameters

symbolstringpathRequired

Stock ticker, e.g. DANGCEM.NG or SCOM.KE.

Example: SCOM.KE

limitintegerquery

Maximum records to return.

Example: 20

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

symbolstring

Example: "SCOM.KE"

historyobject[]

history[].idstring

history[].symbolstring

history[].namestring | null

history[].amountnumber

Dividend per share in the declaration currency.

history[].currencystring

Example: "KES"

history[].exDividendDatestring | null

history[].recordDatestring | null

history[].paymentDatestring | null

history[].statusstring

history[].createdAtstring | null

countinteger

Response codes

200Dividend declaration history for the symbol.

401Unauthorized.

Sandbox playground

Read-only sandbox request

symbol Required · pathlimit Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/dividends/%7Bsymbol%7D/history

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "example": "SCOM.KE"
    },
    "history": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount": {
            "type": "number",
            "description": "Dividend per share in the declaration currency."
          },
          "currency": {
            "type": "string",
            "example": "KES"
          },
          "exDividendDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "recordDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "paymentDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "status": {
            "type": "string"
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        }
      }
    },
    "count": {
      "type": "integer"
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/dividends/%7Bsymbol%7D/history' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

GET /corporate-actions/{actionId}

GET /dividends/calendar