v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB

Market Data

Dividends

Returns historical and upcoming dividend data for companies. Supports stocks and ETFs. Each dividend record includes ex-dividend date, record date, payment date, declaration date, dividend amount, adjusted dividend, yield, and frequency.

post/v1/dividends/query

Request body

limitinteger nullable

The maximum number of dividend records to return per entity. Must be between 1 and 1000.

Example request

{
  "identifier": {
    "value": "4A6F00"
  },
  "limit": 100
}

Response

Successful Response

Example response

{
  "results": [
    {
      "rp_entity_id": "D8442A",
      "target_identifier_id": "AAPL",
      "fields": [
        "DATE",
        "DIVIDEND",
        "ADJ_DIVIDEND",
        "RECORD_DATE",
        "PAYMENT_DATE",
        "DECLARATION_DATE",
        "YIELD",
        "FREQUENCY"
      ],
      "values": [
        [
          "2023-08-11",
          0.24,
          0.24,
          "2023-08-14",
          "2023-08-17",
          "2023-08-03",
          null,
          "Quarterly"
        ],
        [
          "2023-11-10",
          0.24,
          0.24,
          "2023-11-13",
          "2023-11-16",
          "2023-11-02",
          null,
          "Quarterly"
        ]
      ]
    }
  ]
}