Dividends

Dividends Events V2.2

curl --request GET \
  --url 'https://api.benzinga.com/api/v2.2/calendar/dividends?token=' \
  --header 'accept: <accept>'

const options = {method: 'GET', headers: {accept: '<accept>'}};

fetch('https://api.benzinga.com/api/v2.2/calendar/dividends?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v2.2/calendar/dividends?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: <accept>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v2.2/calendar/dividends?token="

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2.2/calendar/dividends?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'

response = http.request(request)
puts response.read_body

{
  "dividends": [
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740U620",
      "date": "2026-12-31",
      "dividend": "0.1636",
      "dividend_prior": "0.1636",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d893cde40001ee2606",
      "importance": 1,
      "isin": "US33740U6203",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - March",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIMR",
      "updated": 1767429336,
      "year": 2027
    },
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740F235",
      "date": "2026-12-31",
      "dividend": "0.1788",
      "dividend_prior": "0.1788",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d393cde40001ee25f5",
      "importance": 1,
      "isin": "US33740F2359",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - June",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIJN",
      "updated": 1767429331,
      "year": 2027
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

GET

api

v2.2

calendar

dividends

Dividends Events V2.2

curl --request GET \
  --url 'https://api.benzinga.com/api/v2.2/calendar/dividends?token=' \
  --header 'accept: <accept>'

const options = {method: 'GET', headers: {accept: '<accept>'}};

fetch('https://api.benzinga.com/api/v2.2/calendar/dividends?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v2.2/calendar/dividends?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: <accept>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v2.2/calendar/dividends?token="

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2.2/calendar/dividends?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'

response = http.request(request)
puts response.read_body

{
  "dividends": [
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740U620",
      "date": "2026-12-31",
      "dividend": "0.1636",
      "dividend_prior": "0.1636",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d893cde40001ee2606",
      "importance": 1,
      "isin": "US33740U6203",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - March",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIMR",
      "updated": 1767429336,
      "year": 2027
    },
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740F235",
      "date": "2026-12-31",
      "dividend": "0.1788",
      "dividend_prior": "0.1788",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d393cde40001ee25f5",
      "importance": 1,
      "isin": "US33740F2359",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - June",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIJN",
      "updated": 1767429331,
      "year": 2027
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

{
  "dividends": [
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740U620",
      "date": "2026-12-31",
      "dividend": "0.1636",
      "dividend_prior": "0.1636",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d893cde40001ee2606",
      "importance": 1,
      "isin": "US33740U6203",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - March",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIMR",
      "updated": 1767429336,
      "year": 2027
    },
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740F235",
      "date": "2026-12-31",
      "dividend": "0.1788",
      "dividend_prior": "0.1788",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d393cde40001ee25f5",
      "importance": 1,
      "isin": "US33740F2359",
      "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - June",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIJN",
      "updated": 1767429331,
      "year": 2027
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

Authorizations

token

string

query

required

Headers

enum<string>

default:application/json

required

Specifies return format. Query parameters work the same for both formats

Available options:

application/json

Query Parameters

page

integer

default:0

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date

pagesize

integer

Number of results returned. Limit 1000

parameters[date]

string<YYYY-MM-DD>

Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest

parameters[date_from]

string<YYYY-MM-DD>

Date to query from point in time

parameters[date_to]

string<YYYY-MM-DD>

Date to query to point in time

parameters[date_sort]

enum<string>

Dividend date field to sort on (newest to oldest)

Available options:

announced,

ex,

payable,

record

parameters[dividend_yield_operation]

enum<string>

Specifies how to filter using dividend yield. gt = Greater Than, gte = Greater Than Equal, eq = Equal, lt = Less Than, lte = Less Than Equal

Available options:

gt,

gte,

eq,

lte,

lt

parameters[dividend_yield]

number

The dividend yield amount to filter by. Defaults to using Equal To the amount indicated. 1 = 100%

parameters[importance]

enum<integer>

The importance level to filter by. Uses Greater Than or Equal To the importance indicated

Available options:

0,

1,

2,

3,

4,

5

parameters[tickers]

string<csv>

One or more ticker symbols separated by a comma. Maximum 50 tickers

parameters[updated]

integer

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated

Response

Success

API response containing an array of dividend records

dividends

object[]

Show child attributes

API Documentation

Guides

Analyst Insights

Bars

Bulls Say Bears Say

Calendars

Company Fundamentals

Corporate Logos

Conference Call Transcripts

Delayed Quotes

Government Trades

Insider Transactions

Market Data

Newsfeed

NewsQuantified

Press Releases

Ticker Trends

Why Is It Moving (WIIMs)

Authorizations

Headers

Query Parameters

Response