--- title: "List Workflows" method: GET path: "/accounts/{account_id}/workflows" tags: ["Workflows"] --- # List Workflows `GET /accounts/{account_id}/workflows` ## Path parameters - `account_id` string, required ## Query parameters - `cursor` string - `limit` integer - `status` 'canceled' | 'confirmed' | 'created' — A category representing a workflow status: - `unified_orders` boolean ## Headers - `LMG-Data-Privacy-Access-Principal` string, required - `LMG-Data-Privacy-Access-Justification` string, required ## Response `200` Successful Response - PageCustomerWorkflowResponse - `data` CustomerWorkflowResponse[], required — The elements of the response. - `id` string, required — A value identifiying the workflow. - `trigger` TriggerResponse, required - `type` 'schedule', required — A category representing the type of the trigger: - `cadence` 'monthly' | 'daily', required — A category describing the cadence for scheduled workflows: - `start_after` string, date — Block workflow execution until the date specified here. This date specifies the last day that the trigger should not be activated. If you want to block a workflow for July 2025, you can pass 2025-07-31 and the trigger will not be activated before 2025-08-01. - `action` ActionDataResponse, required — An object representing a workflow action. - `type` 'order.create_and_confirm' | 'batch_order.create_and_confirm', required — A category representing a workflow action type: - `order` OrderDataResponse, required — An object describing an order to be created as the result of a workflow action. - `type` 'batch', required — The order type for a scheduled workflow. Only batch is supported: orders created by workflows are collected across customers and executed as one composite order. (Market orders are not available for scheduled workflows.) - `side` 'buy' | 'sell', required — A category to represent the side of a customer's order: - `instrument` string, required — An ISIN (International Securities Identification Number) according to ISO 6166. The ISIN specifies the instrument for the order. - `securities_account` string — A securities account identifier. Use this property to specify the securities account for order execution and settlement. If the customer has only one securities account, this property is optional. If the customer has more than one securities account, this property is required. - `amount` string, number, required — The amount of money to invest with each order. - `fee` string, number, required — The fee that will be charged by lemon.markets on your behalf. - `currency` string, required — An ISO 4217 three-letter currency code. Its value represents the currency for the `fee`, `fees.base_amount` and `amount` listed here. The only currently available currency is `"EUR"`. - `regulatory_disclosures` BrokerAppsApiEndpointsCustomerWorkflowsRegulatoryDisclosureResponse - `kid` string - `estimated_price` string, required - `estimated_quantity` string, required - `estimated_amount` string, required - `service_costs_total` string, required - `service_costs_total_pct` string, required - `entry_costs` string, required - `entry_costs_pct` string, required - `third_party_grants` string, required - `third_party_grants_pct` string, required - `acquisition_costs` string, required - `acquisition_costs_pct` string, required - `custody_costs` string, required - `custody_costs_pct` string, required - `product_costs` string, required - `product_costs_pct` string, required - `running_costs` string, required - `running_costs_pct` string, required - `exit_costs` string, required - `exit_costs_pct` string, required - `impact_first_year` string, required - `impact_first_year_pct` string, required - `impact_subsequent_year` string, required - `impact_subsequent_year_pct` string, required - `impact_final_year` string, required - `impact_final_year_pct` string, required - `recurring_impact_year_1` string, required - `recurring_impact_year_1_pct` string, required - `recurring_impact_year_2` string, required - `recurring_impact_year_2_pct` string, required - `recurring_impact_year_3` string, required - `recurring_impact_year_3_pct` string, required - `recurring_impact_year_4` string, required - `recurring_impact_year_4_pct` string, required - `recurring_impact_year_5` string, required - `recurring_impact_year_5_pct` string, required - `recurring_impact_total` string, required - `recurring_impact_total_pct` string, required - `sca` SCAResponse - `required` boolean, required - `challenge` string, required - `appropriateness_consent` AppropriatenessConsentResponse — An object representing the requirements for explicit confirmation of an appropriateness warning. - `required` boolean, required — Requirement indicator for the appropriateness warning. **NOTE:** If this value is `true`, the frontend must present a warning to the user as outlined in your onboarding documentation. - `history` StatusChangeCustomerWorkflowStatus[], required - `status` 'canceled' | 'confirmed' | 'created', required — A category representing a workflow status: - `timestamp` string, date-time, required — The timestamp of the event. It represents the point in time at which the workflow was updated. - `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/revisions/3c8cfd3a96c9/schema)