---
title: "Search by Symbol or Name"
method: POST
path: "/iserver/secdef/search"
tags: ["Contract"]
---

# Search by Symbol or Name

`POST /iserver/secdef/search`

Search by underlying symbol or company name. Relays back what derivative contract(s) it has. This endpoint must be called before using /secdef/info.
If company name is specified will only receive limited response: conid, companyName, companyHeader and symbol.

## Request body

- object
  - `symbol` string, required — symbol or name to be searched
  - `name` boolean — should be true if the search is to be performed by name. false by default.
  - `secType` string — If search is done by name, only the assets provided in this field will be returned. Currently, only STK is supported.

## Response `200`

returns an array of results

- object[]
  - `conid` integer — Contract Identifier
  - `companyHeader` string — Company Name - Exchange
  - `companyName` string
  - `symbol` string — Underlying symbol
  - `description` string — Exchange
  - `restricted` string
  - `fop` string — List of Future Option expirations in YYYMMDD format separated by semicolon
  - `opt` string — List of Option expirations in YYYYMMDD format separated by semicolon
  - `war` string — List of Warrant expirations in YYYYMMDD format separated by semicolon
  - `sections` object[]
    - `secType` string — Asset Class
    - `months` string — List of expiration month(s) and year(s) in MMMYY format separated by semicolon
    - `symbol` string — Underlying symbol
    - `exchange` string — Listing Exchange
    - `legSecType` string — For combo's defines the asset class for each leg

## Other responses

- `500` — error while processing the request

---

[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)