# All Dividends

`GET` `/v1/dividends`

Retrieve dividend history across every ticker: ex-date, record and payment dates, declaration date, cash amount, adjusted dividend, yield and frequency. Results are ordered by ex-date descending, then ticker. Paginate with page and limit (default 50, max 250). Use this for market-wide ex-dividend calendars and income screens.

## Use cases

- Market-wide ex-dividend calendars
- Cross-ticker dividend yield screens
- Income portfolio monitoring across the universe
- Bulk dividend data for total-return models

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | No | Zero-based page (default 0). |
| `limit` | integer | No | Page size, 1-250 (default 50). |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `results` | array | Dividend records across tickers, most recent ex-date first. |
| `results[].ticker` | string | Ticker. |
| `results[].ex_date` | string | Ex-dividend date (YYYY-MM-DD). |
| `results[].record_date` | string | Record date (YYYY-MM-DD). |
| `results[].payment_date` | string | Payment date (YYYY-MM-DD). |
| `results[].declaration_date` | string | Declaration date (YYYY-MM-DD). |
| `results[].adj_dividend` | float | Split-adjusted dividend per share. |
| `results[].dividend` | float | Cash dividend per share. |
| `results[].dividend_yield` | float | Indicated yield at payment (percent). |
| `results[].frequency` | string | Payment frequency label (e.g. Quarterly). |
| `count` | integer | Number of rows on this page. |
| `total` | integer | Total matching dividend rows. |
| `page` | integer | Zero-based page index. |

## Example response

```json
{
  "results": [
    {
      "ticker": "AAPL",
      "ex_date": "2026-05-11",
      "record_date": "2026-05-11",
      "payment_date": "2026-05-14",
      "declaration_date": "2026-04-30",
      "adj_dividend": 0.27,
      "dividend": 0.27,
      "dividend_yield": 0.3587535875,
      "frequency": "Quarterly"
    },
    {
      "ticker": "MSFT",
      "ex_date": "2026-05-14",
      "record_date": "2026-05-15",
      "payment_date": "2026-06-11",
      "declaration_date": "2026-03-10",
      "adj_dividend": 0.83,
      "dividend": 0.83,
      "dividend_yield": 0.72,
      "frequency": "Quarterly"
    }
  ],
  "count": 2,
  "total": 125430,
  "page": 0
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/dividends?limit=50&apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.list_dividends(limit=50)

print(result)
```

### JavaScript

```javascript
import { RestClient } from "vantafin";

const client = new RestClient("vf-live-your_api_key");

const result = await client.listDividends({ limit: 50 });

console.log(result);
```

### Go

```go
package main

import (
	"fmt"
	"log"

	"github.com/vantafin/vantafin-go"
)

func main() {
	client := vantafin.NewClient("vf-live-your_api_key")

	result, err := client.ListDividends(vantafin.Params{"limit": 50})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;
import com.vantafin.Params;

public class Example {
    public static void main(String[] args) throws Exception {
        RestClient client = new RestClient("vf-live-your_api_key");

        Object result = client.listDividends(Params.of().set("limit", 50));

        System.out.println(result);
    }
}
```

### Ruby

```ruby
require "vantafin"

client = Vantafin::RestClient.new("vf-live-your_api_key")

result = client.list_dividends(limit: 50)

pp result
```