Skip to main content
GET
/
api
/
v2.2
/
calendar
/
dividends
Eventos de dividendos V2.2
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.2/calendar/dividends?token=' \
  --header 'accept: <accept>'
{
  "dividends": [
    {
      "confirmed": true,
      "currency": "USD",
      "cusip": 37833100,
      "date": "2024-01-09T00:00:00.000Z",
      "dividend": "0.25",
      "dividend_prior": "0.24",
      "dividend_type": "Cash",
      "dividend_yield": "0.55",
      "end_regular_dividend": false,
      "ex_dividend_date": "2024-01-12T00:00:00.000Z",
      "exchange": "NASDAQ",
      "frequency": 4,
      "id": "60a7f5e8e4b0f5a3c8e9f5a7",
      "importance": 3,
      "isin": "US0378331005",
      "name": "Apple Inc.",
      "notes": "Regular quarterly dividend",
      "payable_date": "2024-02-15T00:00:00.000Z",
      "period": "Q1",
      "record_date": "2024-01-15T00:00:00.000Z",
      "ticker": "AAPL",
      "updated": 1704819600,
      "year": 2024
    }
  ]
}

Authorizations

​
token
string
query
required

Headers

​
accept
enum<string>
default:application/json
required

Especifica el formato de respuesta. Los parámetros de consulta funcionan igual para ambos formatos

Available options:
application/json

Query Parameters

​
page
integer
default:0

Desplazamiento de página. Por motivos de optimización, rendimiento y razones técnicas, los desplazamientos de página están limitados entre 0 y 100000. Limite los resultados de la consulta utilizando otros parámetros, como la fecha.

​
pagesize
integer

Número de resultados devueltos. Límite 1000

​
parameters[date]
string<YYYY-MM-DD>

Fecha para consultar datos de calendar. Abreviatura de date_from y date_to si son iguales. El valor predeterminado es latest.

​
parameters[date_from]
string<YYYY-MM-DD>

Fecha a partir de la cual realizar la consulta

​
parameters[date_to]
string<YYYY-MM-DD>

Fecha de fin de la consulta (punto en el tiempo)

​
parameters[date_sort]
enum<string>

Campo de fecha de dividendo para ordenar (de más reciente a más antiguo)

Available options:
announced,
ex,
payable,
record
​
parameters[dividend_yield_operation]
enum<string>

Especifica cómo filtrar mediante el rendimiento por dividendos. gt = mayor que, gte = mayor o igual que, eq = igual, lt = menor que, lte = menor o igual que

Available options:
gt,
gte,
eq,
lte,
lt
​
parameters[dividend_yield]
number

Importe de la rentabilidad por dividendo para filtrar. De forma predeterminada se utiliza Igual a el importe indicado. 1 = 100%

​
parameters[importance]
enum<integer>

El nivel de importancia por el que se va a filtrar. Utiliza un valor mayor o igual que la importancia indicada

Available options:
0,
1,
2,
3,
4,
5
​
parameters[tickers]
string<csv>

Uno o más símbolos bursátiles separados por comas. Máximo 50 símbolos bursátiles

​
parameters[updated]
integer

Marca de tiempo Unix (UTC) de la última actualización de los registros. Esto obligará a que el orden de clasificación sea Mayor que o Igual que la marca de tiempo indicada

Response

Éxito

Respuesta de la API que contiene un array de registros de dividendos

​
dividends
object[]