---
updatedAt: 2026-06-24T14:31:51.000Z
agentTools:
projectIndex: https://developer.lemon.markets/llms.txt
---
# List Corporate Actions (Account-level)
# 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}/corporate_actions": {
"get": {
"summary": "List Corporate Actions (Account-level)",
"operationId": "list_corporate_actions",
"tags": [
"Corporate Actions"
],
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"title": "Account Identifier"
},
"example": "cusa_20323d55bb264d42b0b225d293591049",
"description": "An account identifier.\n"
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"$ref": "#/components/schemas/CorporateActionType"
},
"description": "Filter corporate actions by type. Available values are `cash_dividend` and `income_distribution`.\n"
},
{
"name": "instrument",
"in": "query",
"required": false,
"schema": {
"type": "string",
"pattern": "^[A-Z]{2}[0-9A-Z]{9}[0-9]$",
"title": "Instrument"
},
"description": "An ISIN (International Securities Identification Number) according to ISO 6166. Use this filter to restrict elements to a specific instrument.\n"
},
{
"name": "securities_account",
"in": "query",
"required": false,
"schema": {
"type": "string",
"title": "Securities Account"
},
"description": "Filter corporate actions by securities account.\n",
"example": "sec_acc_654asdh5bb2ys45g42b0bgtjd2tjt566w41"
},
{
"name": "cursor",
"in": "query",
"required": false,
"description": "A pagination cursor. When you receive a paginated response containing the property `pagination.next_cursor`, you can pass its value here to get the next page of results for your query.\nA cursor will include filter parameters, so there is not need to specify both the `cursor` and any other filter parameter.\n",
"schema": {
"type": "string",
"title": "Cursor"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"description": "In order to customize the number of elements returned, you can provide a limit here. The service will not return more elements than specified.\n",
"schema": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"default": 100,
"title": "Limit"
}
},
{
"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/EncodedPaginatedCollectionResponse_CorporateActionResponseUnion_"
},
"example": {
"data": [
{
"id": "ca_cusa__f076cc37106d4bf7bf5749f423953f35",
"securities_account": "sec_ac_50f9103fbba44a6080658bce20629d39",
"instrument": "DE0009848119",
"type": "income_distribution",
"direction": "credit",
"payable_date": "2026-06-04",
"amount": "0.21",
"currency": "EUR",
"taxes": [
{
"type": "church",
"amount": "0.00",
"direction": "debit"
},
{
"type": "solidarity_surcharge",
"amount": "0.00",
"direction": "debit"
},
{
"type": "capital_gains",
"amount": "0.05",
"direction": "debit"
}
]
},
{
"id": "ca_cusa__b042d117bc254fcba9d845800c413695",
"securities_account": "sec_ac_50f9103fbba44a6080658bce20629d39",
"instrument": "DE0005909006",
"type": "cash_dividend",
"ex_date": "2026-05-19",
"record_date": "2026-05-18",
"payable_date": "2026-05-21",
"amount_per_share": "2.80",
"amount_per_share_currency": "EUR",
"amount": "3278.80",
"currency": "EUR",
"shares_on_ex_date": "1171.00000",
"taxes": [
{
"type": "church",
"amount": "0.00",
"direction": "debit"
},
{
"type": "solidarity_surcharge",
"amount": "45.08",
"direction": "debit"
},
{
"type": "capital_gains",
"amount": "819.70",
"direction": "debit"
}
]
}
],
"pagination": {
"next_cursor": null
}
}
}
}
},
"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"
},
"5XX": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
},
"description": "Server Error"
}
}
}
}
},
"components": {
"schemas": {
"CorporateActionType": {
"type": "string",
"enum": [
"cash_dividend",
"income_distribution",
"instrument_name_change"
],
"title": "CorporateActionType",
"description": "A category representing the type of corporate action:\n cash_dividend: A cash dividend paid out to shareholders. income_distribution: An income or capital distribution from a fund or ETF. instrument_name_change: A change to the instrument's official title.
\nNOTE: This list can be extended in the future. Prepare your code to accept other values, too.\n"
},
"CorporateActionResponseUnion": {
"title": "Corporate Action",
"description": "An object representing a corporate action that affected a customer account. The response is polymorphic, discriminated by the `type` property.\n",
"oneOf": [
{
"$ref": "#/components/schemas/CorporateActionCashDividendResponse"
},
{
"$ref": "#/components/schemas/CorporateActionIncomeDistributionResponse"
}
],
"discriminator": {
"propertyName": "type",
"mapping": {
"cash_dividend": "#/components/schemas/CorporateActionCashDividendResponse",
"income_distribution": "#/components/schemas/CorporateActionIncomeDistributionResponse"
}
}
},
"CorporateActionCashDividendResponse": {
"title": "CorporateActionCashDividendResponse",
"description": "A cash dividend corporate action. Represents a dividend payment to a customer account for shares held at the ex-date.\n",
"properties": {
"id": {
"type": "string",
"title": "Identifier",
"description": "The identifier referring to this corporate action for the customer account.\n"
},
"securities_account": {
"type": "string",
"title": "Securities Account Identifier",
"description": "The securities account identifier associated with this corporate action.\n"
},
"instrument": {
"type": "string",
"title": "Instrument",
"description": "An ISIN (International Securities Identification Number) according to ISO 6166. This value identifies the instrument that paid the dividend.\n"
},
"type": {
"const": "cash_dividend",
"title": "Type",
"description": "The string `\"cash_dividend\"`, identifying this type of corporate action.\n"
},
"ex_date": {
"type": "string",
"format": "date",
"title": "Ex-Date",
"description": "The first day the security trades without the dividend. Shares must be purchased before this date to be eligible for the dividend payment.\n"
},
"record_date": {
"type": "string",
"format": "date",
"title": "Record Date",
"description": "The date lemon.markets checks who is on the shareholder register for dividend eligibility.\n"
},
"payable_date": {
"type": "string",
"format": "date",
"title": "Payable Date",
"description": "The date the dividend is actually paid out. Due to the number of parties involved, it is common for payment to arrive a few business days after this date.\n"
},
"amount_per_share": {
"type": "string",
"title": "Amount Per Share",
"description": "The gross dividend amount per share, represented as a decimal string.\n"
},
"amount_per_share_currency": {
"type": "string",
"title": "Amount Per Share Currency",
"example": "EUR",
"description": "An ISO 4217 three-letter currency code representing the currency of the `amount_per_share` value.\n"
},
"amount": {
"type": "string",
"title": "Amount",
"description": "The total gross dividend amount (before taxes), represented as a decimal string.\n"
},
"currency": {
"type": "string",
"title": "Currency",
"example": "EUR",
"description": "An ISO 4217 three-letter currency code. Represents the currency for `amount` and `taxes`. The only currently available currency is `\"EUR\"`.\n"
},
"shares_on_ex_date": {
"type": "string",
"title": "Shares on Ex-Date",
"description": "The number of shares held at the ex-date cutoff, represented as a decimal string with up to 5 decimal places. This is the quantity used to calculate the total dividend amount.\n"
},
"taxes": {
"items": {
"$ref": "#/components/schemas/TaxResponseField"
},
"type": "array",
"title": "Taxes",
"description": "A list of taxes withheld from this dividend payment.\n"
}
},
"type": "object",
"required": [
"id",
"securities_account",
"instrument",
"type",
"ex_date",
"record_date",
"payable_date",
"amount_per_share",
"amount_per_share_currency",
"amount",
"currency",
"shares_on_ex_date",
"taxes"
]
},
"CorporateActionIncomeDistributionResponse": {
"title": "CorporateActionIncomeDistributionResponse",
"description": "An income distribution corporate action. Represents a distribution from a fund or ETF to a customer account.\n",
"properties": {
"id": {
"type": "string",
"title": "Identifier",
"description": "The identifier referring to this corporate action for the customer account.\n"
},
"securities_account": {
"type": "string",
"title": "Securities Account Identifier",
"description": "The securities account identifier associated with this corporate action.\n"
},
"instrument": {
"type": "string",
"title": "Instrument",
"description": "An ISIN (International Securities Identification Number) according to ISO 6166. This value identifies the instrument that made the distribution.\n"
},
"type": {
"const": "income_distribution",
"title": "Type",
"description": "The string `\"income_distribution\"`, identifying this type of corporate action.\n"
},
"direction": {
"$ref": "#/components/schemas/Direction"
},
"payable_date": {
"type": "string",
"format": "date",
"title": "Payable Date",
"description": "The date the distribution is actually paid out. Due to the number of parties involved, it is common for payment to arrive a few business days after this date.\n"
},
"amount": {
"type": "string",
"title": "Amount",
"description": "The total gross distribution amount (before taxes), represented as a decimal string.\n"
},
"currency": {
"type": "string",
"title": "Currency",
"example": "EUR",
"description": "An ISO 4217 three-letter currency code. Represents the currency for `amount` and `taxes`. The only currently available currency is `\"EUR\"`.\n"
},
"taxes": {
"items": {
"$ref": "#/components/schemas/TaxResponseField"
},
"type": "array",
"title": "Taxes",
"description": "A list of taxes withheld from this distribution.\n"
}
},
"type": "object",
"required": [
"id",
"securities_account",
"instrument",
"type",
"direction",
"payable_date",
"amount",
"currency",
"taxes"
]
},
"Direction": {
"type": "string",
"enum": [
"debit",
"credit"
],
"title": "Direction",
"description": "A category representing the direction of a payment or transaction flow:\n\n"
},
"EncodedPaginatedCollectionResponse_CorporateActionResponseUnion_": {
"properties": {
"data": {
"items": {
"$ref": "#/components/schemas/CorporateActionResponseUnion"
},
"type": "array",
"title": "Data",
"description": "The elements of the response. Each element is a corporate action, discriminated by the `type` property.\n"
},
"pagination": {
"$ref": "#/components/schemas/EncodedPaginationResponse"
}
},
"type": "object",
"required": [
"data",
"pagination"
],
"title": "EncodedPaginatedCollectionResponse[CorporateActionResponseUnion]"
},
"EncodedPaginationResponse": {
"type": "object",
"title": "EncodedPaginationResponse",
"properties": {
"next_cursor": {
"type": "string",
"title": "Next Cursor",
"description": "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.\n"
}
},
"description": "Information about accessing elements beyond the ones that were returned.\n",
"example": {
"next_cursor": ""
}
},
"ErrorResponse": {
"title": "ErrorResponse",
"required": [
"message"
],
"type": "object",
"properties": {
"message": {
"title": "Message",
"type": "string"
}
}
},
"TaxResponseField": {
"properties": {
"type": {
"type": "string",
"title": "Type",
"description": "A string identifying the type of tax that was withheld for a trade:\n capital_gains church_tax solidarity_surcharge
\nNOTE: 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": []
}
]
}
```