---
title: "Details Of A Specific Alert"
method: GET
path: "/iserver/account/alert/{alertId}"
tags: ["tradingAlerts"]
---

# Details Of A Specific Alert

`GET /iserver/account/alert/{alertId}`

Request details of a specific alert by providing the assigned alertId Id.

## Path parameters

- `alertId` integer, required

## Query parameters

- `type` 'Q', required — queryType

## Response `200`

An object containing all unique details of the specified alert.

- AlertDetails — details of the specified alert
  - `account` string — Requestor's account ID
  - `order_id` integer — Alert's tracking ID. Can be used for modifying or deleting alerts.
  - `alertName` string — Human readable name of the alert.
  - `tif` string — Time in Force effective for the Alert
  - `expire_time` string — Returns the UTC formatted date used in GTD orders.
  - `alert_active` '1' | '0' — Returns if the alert is active [1] or disabled [0].
  - `alert_repeatable` integer — Returns if the alert can be sent more than once.
  - `alert_email` string — Returns the designated email address for sendMessage functionality.
  - `alert_send_message` integer — Returns whether or not the alert will send an email.
  - `alert_message` string — Returns the body content of what your alert will report once triggered
  - `alert_show_popup` integer — Returns whether or not the alert will trigger TWS Pop-up messages
  - `alert_play_audio` integer — Returns whether or not the alert will play audio
  - `order_status` 'Presubmitted' | 'Submitted' — represent order statusAlways returns "Presubmitted".
  - `alert_triggered` integer — Returns whether or not the alert was triggered yet.
  - `fg_color` string — Foreground color. Not applicable to API.
  - `bg_color` string — Background color. Not applicable to API.
  - `order_not_editable` boolean — Returns if the order can be edited.
  - `itws_orders_only` integer — Returns whether or not the alert will trigger mobile notifications.
  - `alert_mta_currency` string — Returns currency set for MTA alerts. Only valid for alert type 8 & 9.
  - `alert_mta_defaults` string — Returns current MTA default values.
  - `tool_id` integer — Tracking ID for MTA alerts only. Returns 'null' for standard alerts.
  - `time_zone` string — Returned for time-specific conditions.
  - `alert_default_type` integer — Returns default type set for alerts. Configured in Client Portal.
  - `condition_size` integer — Returns the total number of conditions in the alert.
  - `condition_outside_rth` integer — Returns whether or not the alert will trigger outside of regular trading hours.
  - `conditions` AlertCondition[] — Returns all conditions
    - `condition_type` integer — The type of condition set.
    - `conidex` string — Returns conid and exchange in the format "conid@exchange"
    - `contract_description_1` string — Includes relevant descriptions (if applicable).
    - `condition_operator` string — Condition operator set for alert.
    - `condition_trigger_method` integer — TriggerMethod value set.
    - `condition_value` string — Condition value set.
    - `condition_logic_bind` boolean — Condition logic_bind value set.
    - `condition_time_zone` string — Condition timeZone value set.

## Other responses

- `400` — bad request if orderId is empty or type is invalid
- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — orderId is not parsable; unable to process request
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)