---
title: "Get transaction monitoring configuration"
method: GET
path: "/v1/dem/transactions/{entityId}"
tags: ["dem"]
---

# Get transaction monitoring configuration

`GET /v1/dem/transactions/{entityId}`

## Path parameters

- `entityId` string, required

## Response `200`

The request has succeeded.

- DemGetTransactionResponse
  - `id` string, required — Unique identifier of the transaction.
  - `type` string, required — Entity type, always 'SyntheticTransaction'.
  - `status` 'up' | 'down' | 'paused' | 'maintenance' | 'unknown', required
  - `name` string, required — Name of the transaction, which must be unique within the organization. The name must not contain any control characters, any white space other than space (U+0020), or any consecutive, leading or trailing spaces.
  - `description` string — Description of the transaction.
  - `relatedEntityId` string — Id of an entity to which the transaction is connected.
  - `testDefinition` DemTransactionTestDefinition, required
    - `testFrom` DemTestFrom
      - `type` 'REGION' | 'COUNTRY' | 'CITY', required
      - `values` string[], required — A list of probe location values of the selected type. At least one value matching an existing probe must be provided.
    - `platformOptions` DemProbePlatformOptions
      - `probePlatforms` DemProbePlatform[], required — Cloud platforms hosting synthetic probes.
      - `testFromAll` boolean — Use this field to configure whether availability tests should be performed from all selected platforms or one randomly selected platform. It has no effect if you provided only one platform in the `probePlatforms` field. If set to true, a separate test is made from each of the selected platforms. If set to false, only one of the selected platforms is chosen every time. If omitted, the previous setting will stay in effect. If there is no previous setting, the value will default to false.
    - `outageConfiguration` DemOutageConfiguration
      - `failingTestLocations` 'all' | 'any', required
      - `consecutiveForDown` integer, required — Number of consecutive failing tests for an entity to be considered down.
    - `testIntervalInSeconds` 300 | 600 | 900 | 1800 | 3600 | 7200 | 14400 | 43200 | 86400, required
    - `windowSize` DemWindowSize, required
      - `width` integer, required — Browser window width in pixels.
      - `height` integer, required — Browser window height in pixels.
    - `userAgent` string, nullable — Configure the user agent of the browser running the transaction. If omitted or set to null, default user agent will be used.
    - `commands` DemTransactionCommand[], required — List of commands to perform in the transaction.
      - `command` 'ASSERT_CHECKED' | 'ASSERT_ELEMENT_NOT_PRESENT' | 'ASSERT_ELEMENT_PRESENT' | 'ASSERT_NOT_CHECKED' | 'ASSERT_NOT_SELECTED_VALUE' | 'ASSERT_NOT_TEXT' | 'ASSERT_SELECTED_VALUE' | 'ASSERT_TEXT' | 'ASSERT_VALUE' | 'CHECK' | 'CLICK' | 'CLICK_AT' | 'OPEN' | 'PAUSE' | 'SWO_ASSERT_TEXT_CONTAINS' | 'SWO_ASSERT_TEXT_NOT_CONTAINS' | 'SWO_ASSERT_VALUE_CONTAINS' | 'SWO_ASSERT_VALUE_NOT_CONTAINS' | 'SELECT' | 'SELECT_FRAME' | 'SUBMIT' | 'SWO_ASSERT_URL' | 'SWO_WAIT_FOR_ELEMENT_TEXT_CONTAINS' | 'TYPE' | 'UNCHECK' | 'WAIT_FOR_ELEMENT_PRESENT', required
      - `target` string — Target of the command, e.g. a URL to navigate to, or an element to interact with. All SIDE commands require a target, but some internal commands (e.g. "SWO_RESET") do not.
      - `displayText` string — Human-readable representation of the target element. Usually derived from element's text content, alt attribute or id attribute. Must be omitted for commands that do not target elements ("OPEN", "PAUSE" etc.).
      - `value` string — Value of the command, e.g. a text to type into a text field. Most commands do not require value.
  - `tags` CommonTag[] — Entity tags. Tag is a key-value pair, where there may be only single tag value for the same key.
    - `key` string, required — Tag key.
    - `value` string, required — Tag value.
  - `lastOutageStartTime` string, date-time, nullable — Time when the last outage started.
  - `lastOutageEndTime` string, date-time, nullable — Time when the last outage ended.
  - `lastTestTime` string, date-time, nullable — Time when the last test was performed.
  - `lastErrorTime` string, date-time, nullable — Last time when a synthetic test failed.

## Other responses

- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `500` — Server error

---

[API](https://skmtc.net/solarwinds/apis/solarwinds-observability.md) · [All operations](https://skmtc.net/solarwinds/apis/solarwinds-observability/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarwinds/solarwinds-observability/versions/994e5ca64961/schema)