---
title: "Get MTA alert"
method: GET
path: "/iserver/account/mta"
tags: ["Alert"]
---

# Get MTA alert

`GET /iserver/account/mta`

Each login user only has one mobile trading assistant (MTA) alert with it's own unique tool id.
The tool id cannot be changed. When modified a new order Id is generated. MTA alerts can not
be created or deleted. If you call delete /iserver/account/:accountId/alert/:alertId,
it will reset MTA to default. See [here](https://www.interactivebrokers.com/en/software/mobileiphonemobile/mobileiphone.htm#monitor/trading-assistant.htm) for more information on MTA alerts.

## Response `200`

returns an object

- AlertResponse
  - `account` string — account id
  - `order_id` integer
  - `alert_name` string — name of alert
  - `alert_message` string — The message you want to receive via email or text message
  - `alert_active` integer — whether alert is active or not, so value can only be 0 or 1
  - `alert_repeatable` integer — whether alert is repeatable or not, so value can only be 0 or 1
  - `alert_email` string — email address to receive alert
  - `alert_send_message` integer — whether allowing to send email or not, so value can only be 0 or 1,
  - `tif` string — time in force, can only be GTC or GTD
  - `expire_time` string — format, YYYYMMDD-HH:mm:ss
  - `order_status` string — status of alert
  - `outsideRth` integer — value can only be 0 or 1, set to 1 if the alert can be triggered outside regular trading hours.
  - `itws_orders_only` integer — value can only be 0 or 1, set to 1 to enable the alert only in IBKR mobile
  - `alert_show_popup` integer — value can only be 0 or 1, set to 1 to allow to show alert in pop-ups
  - `alert_triggered` boolean — whether the alert has been triggered
  - `order_not_editable` boolean — whether the alert can be edited
  - `tool_id` integer — for MTA alert only, each user has a unique toolId and it will stay the same, do not send for normal alert
  - `alert_play_audio` string — audio message to play when alert is triggered
  - `alert_mta_currency` string — MTA alert only
  - `alert_mta_defaults` string — MTA alert only
  - `time_zone` string — MTA alert only
  - `alert_default_type` string — MTA alert only
  - `condition_size` integer — size of conditions array
  - `condition_outside_rth` integer — whether allowing the condition can be triggered outside of regular trading hours, 1 means allow
  - `conditions` object[]
    - `condition_type` integer — Types: 1-Price, 3-Time, 4-Margin, 5-Trade, 6-Volume, 7: MTA market 8: MTA Position, 9: MTA Acc. Daily PN&
    - `conidex` string — conid and exchange. Format supports conid or conid@exchange
    - `contract_description_1` string — Format contract name
    - `condition_operator` string — optional, operator for the current condition * >= Greater than or equal to * <= Less than or equal to
    - `condition_trigger_method` string — optional, only some type of conditions have triggerMethod
    - `condition_value` string — can not be empty, can pass default value "*"
    - `condition_logic_bind` string — Condition array should end with "n" * a - AND * o - OR * n - END
    - `condition_time_zone` string — only needed for some MTA alert condition

---

[API](https://skmtc.dev/interactivebrokers/apis/client-portal-web-api.md) · [All operations](https://skmtc.dev/interactivebrokers/apis/client-portal-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactivebrokers/client-portal-web-api/revisions/32edbfe496d1/schema)