---
updatedAt: 2026-04-21T12:52:44.000Z
agentTools:
  projectIndex: https://developer.lemon.markets/llms.txt
---

# Get Income Distribution

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "lemon.markets Brokerage API 🍋",
    "version": "0.1.0"
  },
  "x-readme": {
    "proxy-enabled": false,
    "samples-languages": [
      "shell",
      "python",
      "go"
    ]
  },
  "servers": [
    {
      "url": "https://sandbox.api.lemon.markets/v1",
      "description": "Sandbox"
    }
  ],
  "tags": [
    {
      "name": "Corporate Actions"
    }
  ],
  "paths": {
    "/accounts/{account_id}/income_distributions/{income_distribution_id}": {
      "get": {
        "summary": "Get Income Distribution",
        "operationId": "get_income_distribution",
        "tags": [
          "Corporate Actions"
        ],
        "parameters": [
          {
            "name": "income_distribution_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Income Distribution Identifier"
            },
            "description": "An Income Distribution Identifier\n"
          },
          {
            "name": "account_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Account Identifier"
            },
            "example": "cusa_20323d55bb264d42b0b225d293591049",
            "description": "An account identifier.\n"
          },
          {
            "name": "LMG-Data-Privacy-Access-Principal",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Lmg-Data-Privacy-Access-Principal"
            }
          },
          {
            "name": "LMG-Data-Privacy-Access-Justification",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Lmg-Data-Privacy-Access-Justification"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IncomeDistributionResponse"
                },
                "example": {
                  "amount": "100.01",
                  "currency": "EUR",
                  "direction": "credit",
                  "id": "ca_am_9550285db6174488b3ddcb9e7ce5c95b",
                  "instrument": "IE000CNSFAR2",
                  "payable_date": "2025-02-24",
                  "taxes": [
                    {
                      "amount": "2.20",
                      "direction": "debit",
                      "type": "church"
                    },
                    {
                      "amount": "1.34",
                      "direction": "debit",
                      "type": "solidarity_surcharge"
                    },
                    {
                      "amount": "24.45",
                      "direction": "debit",
                      "type": "capital_gains"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Unprocessable Entity"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server Error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Direction": {
        "type": "string",
        "enum": [
          "debit",
          "credit"
        ],
        "title": "Direction",
        "description": "A category representing the direction of a payment or transaction flow:\n<ul> <li><code>credit</code> <li><code>debit</code> </ul>\n"
      },
      "ErrorResponse": {
        "title": "ErrorResponse",
        "required": [
          "message"
        ],
        "type": "object",
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          }
        }
      },
      "IncomeDistributionResponse": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Identifier",
            "description": "The identifier referring to this income distribution.\n"
          },
          "instrument": {
            "type": "string",
            "title": "Instrument",
            "description": "An ISIN (International Securities Identification Number) according to ISO 6166. This value identified the instrument distributing and amount.\n"
          },
          "payable_date": {
            "type": "string",
            "format": "date",
            "title": "Payable Date",
            "description": "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.\n"
          },
          "currency": {
            "type": "string",
            "title": "Currency",
            "example": "EUR",
            "description": "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\"`.\n"
          },
          "direction": {
            "$ref": "#/components/schemas/Direction"
          },
          "amount": {
            "type": "string",
            "title": "Amount",
            "description": "The amount of cash received before applying taxes.\n"
          },
          "taxes": {
            "items": {
              "$ref": "#/components/schemas/TaxResponseField"
            },
            "type": "array",
            "title": "Taxes"
          }
        },
        "type": "object",
        "required": [
          "id",
          "instrument",
          "payable_date",
          "direction",
          "amount",
          "currency"
        ],
        "title": "IncomeDistributionResponse"
      },
      "TaxResponseField": {
        "properties": {
          "type": {
            "type": "string",
            "title": "Type",
            "description": "A string identifying the type of tax that was withheld for a trade:\n<ul> <li><code>capital_gains</code> <li><code>church_tax</code> <li><code>solidarity_surcharge</code> </ul>\n<strong>NOTE:</strong> This list can be extended in the future.  Prepare your code to accept other values, too.\n"
          },
          "amount": {
            "type": "string",
            "title": "Amount",
            "description": "The monetary amount representing this tax.\n"
          },
          "direction": {
            "$ref": "#/components/schemas/Direction"
          }
        },
        "type": "object",
        "required": [
          "type",
          "amount",
          "direction"
        ],
        "title": "TaxResponseField"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```