---
title: "List Income Distributions"
method: GET
path: "/accounts/{account_id}/income_distributions"
tags: ["Corporate Actions"]
---

# List Income Distributions

`GET /accounts/{account_id}/income_distributions`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/income_distributions`
- Auth: HTTP bearer

## Path parameters

- `account_id` string, required

## Query parameters

- `instrument` string
- `cursor` string
- `limit` integer

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponseIncomeDistributionResponse
  - `data` IncomeDistributionResponse[], required: The elements of the response.
    - `id` string, required: The identifier referring to this income distribution.
    - `instrument` string, required: An ISIN (International Securities Identification Number) according to ISO 6166. This value identified the instrument distributing and amount.
    - `payable_date` string, date, required: The expected payable date. The payment cannot be expected to happen earlier than this date. Due to the number of parties involved, it is common for payment to arrive a few business days after this date.
    - `currency` string, required: An ISO 4217 three-letter currency code. Its value represents the currency for the amount and taxes listed here. The only currently available currency is `"EUR"`.
    - `direction` 'debit' | 'credit', required: A category representing the direction of a payment or transaction flow: <ul> <li><code>credit</code> <li><code>debit</code> </ul>
    - `amount` string, required: The amount of cash received before applying taxes.
    - `taxes` TaxResponseField[]
      - `type` string, required: A string identifying the type of tax that was withheld for a trade: <ul> <li><code>capital_gains</code> <li><code>church_tax</code> <li><code>solidarity_surcharge</code> </ul> <strong>NOTE:</strong> This list can be extended in the future. Prepare your code to accept other values, too.
      - `amount` string, required: The monetary amount representing this tax.
      - `direction` 'debit' | 'credit', required: A category representing the direction of a payment or transaction flow: <ul> <li><code>credit</code> <li><code>debit</code> </ul>
  - `pagination` EncodedPaginationResponse, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)