---
title: "Dividends"
method: POST
path: "/v1/dividends/query"
tags: ["Market Data"]
---

# Dividends

`POST /v1/dividends/query`

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.

## Request body

- DividendsQuery
  - `identifier` SingleIdentifier, required
    - `type` 'rp_entity_id', required
    - `value` string, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
  - `limit` integer, nullable — The maximum number of dividend records to return per entity. Must be between 1 and 1000.

## Response `200`

Successful Response

- DividendsResponse — Company Dividends response model.
  - `results` DividendsResults[], required — The main data result
    - `rp_entity_id` string, nullable, required — RP Entity identifier
    - `target_identifier_id` string, nullable, required — The external identifier ID, such as a symbol
    - `fields` string[], required — Column names for the data values
    - `values` array[], required — Dividend records. Each array contains [date, dividend, adjDividend, recordDate, paymentDate, declarationDate, yield, frequency]
      - union[]
        - union
          - string
          - number
  - `errors` ErrorDetail[], nullable
    - `message` string, nullable
  - `metadata` Metadata
    - `request_id` string, required
    - `timestamp` string

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)