---
title: "Scanner Run"
method: POST
path: "/iserver/scanner/run"
tags: ["Scanner"]
---

# Scanner Run

`POST /iserver/scanner/run`

Searches for contracts according to the filters specified in scanner/params endpoint

## Request body

- ScannerParams
  - `instrument` string — Contains an instrument, which to scan for. For example - "STK"
  - `type` string — Specify the scan type to use. For example - "MOST_ACTIVE_USD"
  - `location` string — Contains location code, where to look for specified instrument. For example - "STK.US.MAJOR"
  - `filter` object[] — Contains list of filters supported for the scanner
    - `code` string
    - `value` number

## Response `200`

returns an array

- object[]
  - `server_id` string
  - `column_name` string
  - `symbol` string — Underlying symbol
  - `conidex` string — conid and exchange. Format supports conid or conid@exchange
  - `con_id` number
  - `available_chart_periods` string — List of available chart periods
  - `company_name` string — Contracts company name
  - `contract_description_1` string — Format contract name
  - `listing_exchange` string
  - `sec_type` string

---

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