REST API Tutorial 17: Search for an Equity

Last update Jan 2026
Environment Any
Language Any HTTP is supported
Compilers None
Prerequisites DSS login, internet access
Source code Below

Tutorial purpose

This tutorial explains how to make a search request for an equity, using as criteria the exchange and the ticker (other criteria are also available).

Important note: contrary to the historical search capabilities, this search capability (and the following ones) only returns instruments that are currently active, it will not include historical instruments.

 

Table of contents


Equity search by exchange and ticker - HTTP request

Note:

  • For all requests we need to include a user token in the header of our request. This was retrieved in Tutorial 1.

The body of the request contains the list of available search criteria:

  • In this example we search for active instruments, using a list of exchange codes and a ticker.
  • Other combinations are of course possible. See the REST API Reference Tree for more information on the search criteria.

The following request searches for all valid instruments corresponding to a specific ticker, on two specific exchanges.

URL:               

    	
            https://selectapi.datascope.lseg.com/RestApi/v1/Search/EquitySearch

Method:          POST

Headers:

    	
            
Prefer: respond-async


Content-Type: application/json


Authorization: Token F0ABE9A3FFF2E02E10AE2765ED872C59B8CC3B40EBB61B30E295E71DE31C254B8648DB9434C2DF9299FDC668AA123501F322D99D45C8B93438063C912BC936C7B87062B0CF812138863F5D836A7B31A32DCA67EF07B3B50B2FC4978DF6F76784FDF35FCB523A8430DA93613BC5730CDC310D4D241718F9FC3F2E55465A24957CC287BDEC79046B31AD642606275AEAD76318CB221BD843348E1483670DA13968D8A242AAFCF9E13E23240C905AE46DED9EDCA9BB316B4C5C767B18DB2EA7ADD100817ADF059D01394BC6375BECAF6138C25DBA57577F0061

Body:

    	
            
{


  "SearchRequest": {


    "AssetStatus": "Active",


    "AssetCategoryCodes": null,


    "SubTypeCodes": null,


    "CurrencyCodes": null,


    "CompanyName": null,


    "Description": null,


    "DomicileCodes": null,


    "ExchangeCodes": ["LTG","XMG"],


    "FairValueIndicator": null,


    "FileCodes": null,


    "GicsCodes": null,


    "OrgId": null,


    "Ticker": "UG",


    "Identifier": null,


    "IdentifierType": null,


    "PreferredIdentifierType": null


  }


}

 

Equity search by exchange and ticker - HTTP response

Status:                        200 OK

Relevant headers:

    	
            Content-Type: application/json; charset=utf-8

Body:

    	
            
{


    "@odata.context": "https://selectapi.datascope.lseg.com/RestApi/v1/$metadata#Collection(DataScope.Select.Api.Search.EquitySearchResult)",


    "value": [


        {


            "Identifier": "UG.LTS",


            "IdentifierType": "Ric",


            "Source": "LTG",


            "Key": "VjF8MHgwMDAzZGQwMDE1OGIzMDcwfDB4MDAxMDBiMDAyMzkwNGMwMHxMVEd8RVFRVXxFUVRZfE9EU0h8RXx8VUcuTFRTfDQ1MjE",


            "Description": "UNITED GUARDIAN ORD",


            "InstrumentType": "EquityQuote",


            "Status": "Valid",


            "DomicileCode": "US",


            "CurrencyCodes": "USD",


            "SubTypeCode": "ODSH",


            "AssetStatus": "Active",


            "IssuerName": "UNITED GUARDIAN",


            "IssuerOrgId": "32440",


            "Exchange": "LTG",


            "FileCode": "4521"


        },


        {


            "Identifier": "UG.MEM",


            "IdentifierType": "Ric",


            "Source": "XMG",


            "Key": "VjF8MHgwMDAzZGQwMDE1OGIzMDcwfDB4MDAxMDBiMDAyM2FkZDFkZnxYTUd8RVFRVXxFUVRZfE9EU0h8RXx8VUcuTUVNfDQ1ODM",


            "Description": "UNITED GUARDIAN ORD",


            "InstrumentType": "EquityQuote",


            "Status": "Valid",


            "DomicileCode": "US",


            "CurrencyCodes": "USD",


            "SubTypeCode": "ODSH",


            "AssetStatus": "Active",


            "IssuerName": "UNITED GUARDIAN",


            "IssuerOrgId": "32440",


            "Exchange": "XMG",


            "FileCode": "4583"


        }


    ]


}