---
title: "Get Events"
method: GET
path: "/events"
tags: ["Events + Webhooks"]
---

# Get Events

`GET /events`

## Query parameters

- `context.account` string
- `context.batch_order` string
- `context.identification` string
- `context.order` string
- `context.person` string
- `context.securities_account` string — A securities account identifier. Specify one to restrict responses to events with a matching `securities_account` in their `context` object.
- `context.securities_transfer` string
- `context.sweep` string
- `context.tax_exemption_order` string
- `context.trade` string
- `context.transaction` string
- `context.treasury_mandate` string
- `context.treasury_transfer` string
- `context.update` string
- `context.workflow` string
- `cursor` string
- `limit` integer
- `since` string, date-time
- `sort` 'asc' | 'desc' — A category representing a sort order: <ul> <li><code>asc</code>: Sort elements in descending order. For timestamp based sorting this means starting with oldest element and then moving forward in time. <li><code>desc</code>: Sort elements in descending order. For timestamp based sorting this means starting with most recent element and then going further back in time. </ul>
- `type` 'account.closed' | 'account.created' | 'account.opened' | 'account.rejected' | 'batch_order.accepted' | 'batch_order.canceled' | 'batch_order.canceling' | 'batch_order.confirmed' | 'batch_order.created' | 'batch_order.executed' | 'batch_order.rejected' | 'cash_account.created' | 'check.action_required' | 'check.processing' | 'check.pending' | 'check.succeeded' | 'check.failed' | 'corporate_action.created' | 'corporate_action.processed' | 'deposit.created' | 'deposit.rejected' | 'deposit.received' | 'dividend_distribution.created' | 'document.created' | 'identification.created' | 'identification.failed' | 'identification.started' | 'identification.succeeded' | 'income_distribution.created' | 'order.accepted' | 'order.canceled' | 'order.canceling' | 'order.confirmed' | 'order.created' | 'order.executed' | 'order.rejected' | 'securities_account.created' | 'securities_account.opened' | 'securities_account.rejected' | 'securities_account.closed' | 'securities_transfer.created' | 'securities_transfer.completed' | 'settlement.created' | 'sweep.canceled' | 'sweep.created' | 'sweep.processed' | 'sweep.rejected' | 'sweep.started' | 'tax.canceled' | 'tax.created' | 'tax.processed' | 'tax_exemption_order.accepted' | 'tax_exemption_order.canceled' | 'tax_exemption_order.canceling' | 'tax_exemption_order.created' | 'tax_exemption_order.rejected' | 'trade.cash_settled' | 'trade.created' | 'trade.taxes_processed' | 'treasury_mandate.accepted' | 'treasury_mandate.canceled' | 'treasury_mandate.confirmed' | 'treasury_mandate.created' | 'treasury_mandate.rejected' | 'treasury_transfer.created' | 'treasury_transfer.pending' | 'treasury_transfer.processed' | 'treasury_transfer.canceled' | 'treasury_transfer.canceling' | 'treasury_transfer.settled' | 'treasury_transfer.rejected' | 'update.created' | 'update.succeeded' | 'update.failed' | 'withdrawal.accepted' | 'withdrawal.canceled' | 'withdrawal.confirmed' | 'withdrawal.created' | 'withdrawal.processed' | 'withdrawal.rejected' | 'workflow.created' | 'workflow.confirmed' | 'workflow.canceled' — A category representing a type of event. <ul> <li> <code>account.closed</code>, <code>account.created</code>, <code>account.opened</code>, <code>account.rejected</code> <li> <code>batch_order.accepted</code>, <code>batch_order.canceled</code>, <code>batch_order.canceling</code>, <code>batch_order.confirmed</code>, <code>batch_order.created</code>, <code>batch_order.executed</code>, <code>batch_order.rejected</code> <li> <code>cash_account.created</code> <li> <code>check.action_required</code>, <code>check.processing</code>, <code>check.pending</code>, <code>check.succeeded</code>, <code>check.failed</code> <li> <code>deposit.created</code>, <code>deposit.rejected</code>, <code>deposit.received</code> <li> <code>dividend_distribution.created</code> <li> <code>document.created</code> <li> <code>identification.created</code>, <code>identification.failed</code>, <code>identification.started</code>, <code>identification.succeeded</code> <li> <code>income_distribution.created</code> <li> <code>order.accepted</code>, <code>order.canceled</code>, <code>order.canceling</code>, <code>order.confirmed</code>, <code>order.created</code>, <code>order.executed</code>, <code>order.rejected</code> <li> <code>securities_account.created</code>, <code>securities_account.opened</code>, <code>securities_account.rejected</code>, <code>securities_account.closed</code> <li> <code>securities_transfer.created</code>, <code>securities_transfer.completed</code> <li> <code>settlement.created</code> <li> <code>sweep.canceled</code>, <code>sweep.created</code>, <code>sweep.rejected</code>, <code>sweep.processed</code>, <code>sweep.started</code> <li> <code>tax.canceled</code>, <code>tax.created</code>, <code>tax.processed</code> <li> <code>tax_exemption_order.accepted</code>, <code>tax_exemption_order.canceled</code>, <code>tax_exemption_order.canceling</code>, <code>tax_exemption_order.created</code>, <code>tax_exemption_order.rejected</code> <li> <code>trade.cash_settled</code> <code>trade.created</code> <code>trade.taxes_processed</code> <li> <code>treasury_mandate.accepted</code>, <code>treasury_mandate.canceled</code>, <code>treasury_mandate.confirmed</code>, <code>treasury_mandate.created</code>, <code>treasury_mandate.rejected</code> <li> <code>treasury_transfer.canceled</code>, <code>treasury_transfer.canceling</code>, <code>treasury_transfer.created</code>, <code>treasury_transfer.pending</code>, <code>treasury_transfer.processed</code>, <code>treasury_transfer.rejected</code>, <code>treasury_transfer.settled</code> <li> <code>update.created</code>, <code>update.succeeded</code>, <code>update.failed</code> <li> <code>withdrawal.accepted</code>, <code>withdrawal.canceled</code>, <code>withdrawal.confirmed</code>, <code>withdrawal.created</code>, <code>withdrawal.processed</code>, <code>withdrawal.rejected</code> <li> <code>workflow.canceled</code>, <code>workflow.confirmed</code>, <code>workflow.created</code> </ul> <strong>Note:</strong> This list is not final, more types of events will be added in the future.

## Headers

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

## Response `200`

Successful Response

- PageEventExternal
  - `data` EventExternal[], required — The elements of the response.
    - `id` string, required — An event identifier.
    - `type` 'account.closed' | 'account.created' | 'account.opened' | 'account.rejected' | 'batch_order.accepted' | 'batch_order.canceled' | 'batch_order.canceling' | 'batch_order.confirmed' | 'batch_order.created' | 'batch_order.executed' | 'batch_order.rejected' | 'cash_account.created' | 'check.action_required' | 'check.processing' | 'check.pending' | 'check.succeeded' | 'check.failed' | 'corporate_action.created' | 'corporate_action.processed' | 'deposit.created' | 'deposit.rejected' | 'deposit.received' | 'dividend_distribution.created' | 'document.created' | 'identification.created' | 'identification.failed' | 'identification.started' | 'identification.succeeded' | 'income_distribution.created' | 'order.accepted' | 'order.canceled' | 'order.canceling' | 'order.confirmed' | 'order.created' | 'order.executed' | 'order.rejected' | 'securities_account.created' | 'securities_account.opened' | 'securities_account.rejected' | 'securities_account.closed' | 'securities_transfer.created' | 'securities_transfer.completed' | 'settlement.created' | 'sweep.canceled' | 'sweep.created' | 'sweep.processed' | 'sweep.rejected' | 'sweep.started' | 'tax.canceled' | 'tax.created' | 'tax.processed' | 'tax_exemption_order.accepted' | 'tax_exemption_order.canceled' | 'tax_exemption_order.canceling' | 'tax_exemption_order.created' | 'tax_exemption_order.rejected' | 'trade.cash_settled' | 'trade.created' | 'trade.taxes_processed' | 'treasury_mandate.accepted' | 'treasury_mandate.canceled' | 'treasury_mandate.confirmed' | 'treasury_mandate.created' | 'treasury_mandate.rejected' | 'treasury_transfer.created' | 'treasury_transfer.pending' | 'treasury_transfer.processed' | 'treasury_transfer.canceled' | 'treasury_transfer.canceling' | 'treasury_transfer.settled' | 'treasury_transfer.rejected' | 'update.created' | 'update.succeeded' | 'update.failed' | 'withdrawal.accepted' | 'withdrawal.canceled' | 'withdrawal.confirmed' | 'withdrawal.created' | 'withdrawal.processed' | 'withdrawal.rejected' | 'workflow.created' | 'workflow.confirmed' | 'workflow.canceled', required — A category representing a type of event. <ul> <li> <code>account.closed</code>, <code>account.created</code>, <code>account.opened</code>, <code>account.rejected</code> <li> <code>batch_order.accepted</code>, <code>batch_order.canceled</code>, <code>batch_order.canceling</code>, <code>batch_order.confirmed</code>, <code>batch_order.created</code>, <code>batch_order.executed</code>, <code>batch_order.rejected</code> <li> <code>cash_account.created</code> <li> <code>check.action_required</code>, <code>check.processing</code>, <code>check.pending</code>, <code>check.succeeded</code>, <code>check.failed</code> <li> <code>deposit.created</code>, <code>deposit.rejected</code>, <code>deposit.received</code> <li> <code>dividend_distribution.created</code> <li> <code>document.created</code> <li> <code>identification.created</code>, <code>identification.failed</code>, <code>identification.started</code>, <code>identification.succeeded</code> <li> <code>income_distribution.created</code> <li> <code>order.accepted</code>, <code>order.canceled</code>, <code>order.canceling</code>, <code>order.confirmed</code>, <code>order.created</code>, <code>order.executed</code>, <code>order.rejected</code> <li> <code>securities_account.created</code>, <code>securities_account.opened</code>, <code>securities_account.rejected</code>, <code>securities_account.closed</code> <li> <code>securities_transfer.created</code>, <code>securities_transfer.completed</code> <li> <code>settlement.created</code> <li> <code>sweep.canceled</code>, <code>sweep.created</code>, <code>sweep.rejected</code>, <code>sweep.processed</code>, <code>sweep.started</code> <li> <code>tax.canceled</code>, <code>tax.created</code>, <code>tax.processed</code> <li> <code>tax_exemption_order.accepted</code>, <code>tax_exemption_order.canceled</code>, <code>tax_exemption_order.canceling</code>, <code>tax_exemption_order.created</code>, <code>tax_exemption_order.rejected</code> <li> <code>trade.cash_settled</code> <code>trade.created</code> <code>trade.taxes_processed</code> <li> <code>treasury_mandate.accepted</code>, <code>treasury_mandate.canceled</code>, <code>treasury_mandate.confirmed</code>, <code>treasury_mandate.created</code>, <code>treasury_mandate.rejected</code> <li> <code>treasury_transfer.canceled</code>, <code>treasury_transfer.canceling</code>, <code>treasury_transfer.created</code>, <code>treasury_transfer.pending</code>, <code>treasury_transfer.processed</code>, <code>treasury_transfer.rejected</code>, <code>treasury_transfer.settled</code> <li> <code>update.created</code>, <code>update.succeeded</code>, <code>update.failed</code> <li> <code>withdrawal.accepted</code>, <code>withdrawal.canceled</code>, <code>withdrawal.confirmed</code>, <code>withdrawal.created</code>, <code>withdrawal.processed</code>, <code>withdrawal.rejected</code> <li> <code>workflow.canceled</code>, <code>workflow.confirmed</code>, <code>workflow.created</code> </ul> <strong>Note:</strong> This list is not final, more types of events will be added in the future.
    - `created_at` string, date-time, required — A timestamp representation the moment of an event's creation.
    - `context` union, required
      - AccountEventContext — An object representing the context of an event.
        - `account` string, required — An account identifier. This field represents the account associated with an event.
      - BatchOrderEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `batch_order` string, required — A batch order identifier. This field represents the batch order associated with an event.
      - CustomerAccountCheckEventContext — An object describing the context of an account check event.
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `check` string, required — A check identifier. This field represents the check associated with an event. It is an opaque identifier for event correlation, not meant to look-up a specific check.
      - CustomerWorkflowEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `workflow` string, required — A workflow identifier. This field represents the workflow associated with an event.
      - CustomerWorkflowDocumentEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `document` string, required — A document identifier. This field represents the document associated with an event.
        - `workflow` string, required — A workflow identifier. This field represents the workflow associated with an event.
      - CustomerWorkflowOrderTradeDocumentEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `batch_order` string, required — A batch order identifier. This field represents the batch order associated with an event.
        - `document` string, required — A document identifier. This field represents the document associated with an event.
        - `order` string — An order identifier. This field represents the order associated with an event.
        - `trade` string, required — A trade identifier. This field represents the trade associated with an event.
        - `transaction` string, required — A transaction identifier. This field represents the transaction associated with an event.
        - `workflow` string, required — A workflow identifier. This field represents the workflow associated with an event.
      - BatchOrderEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `batch_order` string, required — A batch order identifier. This field represents the batch order associated with an event.
      - DepositEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `deposit` string, required — A deposit identifier. This field represents the deposit associated with an event.
      - DepositTransactionEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `deposit` string, required — A deposit identifier. This field represents the deposit associated with an event.
        - `transaction` string, required — A transaction identifier. This field represents the transaction associated with an event.
      - DividendDistributionEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `dividend_distribution` string, required — A dividend distribution identifier. This field represents the cash dividend distribution associated with an event.
        - `securities_account` string, required — A securities account identifier.
        - `transaction` string, required — A transaction identifier. This field represents the transaction associated with an event.
      - DocumentEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `document` string, required — A document identifier. This field represents the document associated with an event.
      - IdentificationEventContext
        - `person` string, required
        - `identification` string, required
      - IncomeDistributionConfirmationDocumentEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `document` string, required — A document identifier. This field represents the document associated with an event.
        - `income_distribution` string, required — An income distribution identifier. This field represents the income distribution associated with an event.
      - IncomeDistributionEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `income_distribution` string, required — An income distribution identifier. This field represents the income distribution associated with an event.
        - `securities_account` string, required — A securities account identifier.
      - OrderDocumentEventContext
        - `account` string, required
        - `document` string, required
        - `batch_order` string, required
        - `order` string, nullable
      - OrderEventContext
        - `account` string, required
        - `order` string, required
      - TradeEventContext
        - `account` string, required
        - `securities_account` string, required
        - `trade` string, required
        - `order` string, required
      - TradeSettledEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `order` string, required — An order identifier. This field represents the order associated with an event.
        - `trade` string, required — A trade identifier. This field represents the trade associated with an event.
        - `transaction` string, required — A transaction identifier. This field represents the transaction associated with an event.
      - OrderTradeDocumentEventContext
        - `account` string, required
        - `document` string, required
        - `batch_order` string, required
        - `order` string, nullable
        - `trade` string, required
        - `transaction` string, nullable
      - OrderWorkflowEventContext
        - `account` string, required
        - `order` string, required
        - `workflow` string, required
      - PersonDataUpdateEventContext
        - `person` string, required — A person identifier. This field represents the person associated with a data update request event.
        - `update` string, required — A person data update request identifier. This field represents the update request associated with an event.
      - SecuritiesAccountEventContext
        - `account` string, required — An account identifier. This field represents the customer account associated with an event.
        - `securities_account` string, required — A securities account identifier. This field represents the securities account associated with an event.
      - SecuritiesTransferEventContext — An object representing the context of an event.
        - `account` string, required — An account identifier. This field represents the account associated with the event.
        - `transaction` string, required — A transaction identifier. This field represents the transaction associated with the event.
        - `securities_transfer` string, required — A securities transfer identifier. You can use this field to correlate different events relating to the same securities transfer.
      - SettlementEventContext
        - `settlement` string — A settlement identifier. This field represents the settlement associated with an event.
        - `settlement_account` string — A settlement account identifier. This field represents the settlement account associated with an event.
      - TaxExemptionOrderEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `tax_exemption_order` string, required — A tax exemption order identifier. This field represents the tax exemption order associated with an event.
      - TaxGeneralEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `tax` string, required — A tax payment identifier. This field represents the tax payment associated with an event.
        - `transaction` string, required — A transaction identifier. This field represents the transaction associated with an event.
      - TaxInstrumentTransactionEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `instrument` string, required — An ISIN (International Securities Identification Number) according to ISO 6166. This field represents the instrument associated with an event.
        - `tax` string, required — A tax payment identifier. This field represents the tax payment associated with an event.
        - `transaction` string, required — A transaction identifier. This field represents the transaction associated with an event.
      - TreasuryMandateEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `treasury_mandate` string, required — A treasury mandate identifier. This field represents the treasury mandate associated with an event.
      - TreasuryTransferEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `order` string, required — An order identifier. This field represents the order associated with an event.
        - `treasury_transfer` string, required — An treasury transfer identifier. This field represents the treasury transfer associated with an event.
      - TreasuryTransferSettlementEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `order` string, required — An order identifier. This field represents the order associated with an event.
        - `trade` string, required — A trade identifier. This field represents the trade associated with an event.
        - `treasury_transfer` string, required — A treasury transfer identifier. This field represents the treasury transfer associated with an event.
      - WithdrawalEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `withdrawal` string, required — A withdrawal identifier. This field represents the withdrawal associated with an event.
      - WithdrawalTransactionEventContext
        - `account` string, required — An account identifier. This field represents the account associated with an event.
        - `transaction` string, required — A transaction identifier. This field represents the transaction associated with an event.
        - `withdrawal` string, required — A withdrawal identifier. This field represents the withdrawal associated with an event.
  - `pagination` Pagination, 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.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/versions/3c8cfd3a96c9/schema)