Fetch Reference Data

Perform a search for securities using a symbol or other search criteria.

GET /api/v1/securities

Try it

Fetch Reference Data

cURL

curl --request GET \
  --url 'https://api.finvera.news/search/api/v1/securities?apikey='

Response (200 OK)

{
  "data": {
    "facet_counts": [],
    "found": 1,
    "hits": [
      {
        "document": {
          "classification.gics": "Information Technology/Technology Hardware & Equipment/Technology Hardware, Storage & Peripherals/Technology Hardware, Storage & Peripherals",
          "classification.gics_code": "45202030",
          "classification.market_sector": "Equity",
          "classification.security_description": "AAPL",
          "classification.security_type": "Common Stock",
          "classification.security_type2": "Common Stock",
          "classification.sic_code": "3571",
          "classification.sic_description": "ELECTRONIC COMPUTERS",
          "company_info.address.address1": "ONE APPLE PARK WAY",
          "company_info.address.city": "CUPERTINO",
          "company_info.address.postal_code": "95014",
          "company_info.address.state": "CA",
          "company_info.description": "Apple is among the largest companies in the world, with a broad portfolio of hardware and software products targeted at consumers and businesses.",
          "company_info.homepage_url": "https://www.apple.com",
          "company_info.list_date": "1980-12-12",
          "company_info.phone_number": "[phone]",
          "company_info.total_employees": 164000,
          "created_at": "2025-04-06T04:35:40.413507Z",
          "exchange_info.exchange_country": "USA",
          "exchange_info.exchange_name": "NASDAQ Global Select Consolidated",
          "exchange_info.mic_code": "XNAS",
          "exchange_info.openfigi_exchange_code": "US",
          "exchange_info.openfigi_ticker": "AAPL",
          "exchange_info.refinitiv_exchange_code": "NSQ",
          "exchange_info.refinitiv_exchange_name": "NASDAQ Global Select Consolidated",
          "financials.market_cap": 3327840000000,
          "financials.round_lot": 100,
          "financials.share_class_shares_outstanding": 15022070000,
          "financials.weighted_shares_outstanding": 15022073000,
          "id": "BBG000B9XRY4_XNAS",
          "identifiers.cik": "0000320193",
          "identifiers.cusip": "037833100",
          "identifiers.figi": "BBG000B9XRY4",
          "identifiers.figi_composite": "BBG000B9XRY4",
          "identifiers.figi_share_class": "BBG001S5N8V8",
          "identifiers.isin": "US0378331005",
          "identifiers.opol": "XNAS",
          "identifiers.permid": "55838974642",
          "identifiers.ric": "AAPL.O",
          "isin_history": null,
          "name": "APPLE INC",
          "status": "ACTIVE",
          "symbol": "AAPL",
          "ticker_meta.active": true,
          "ticker_meta.currency_name": "usd",
          "ticker_meta.last_updated_utc": "2025-03-26T00:00:00Z",
          "ticker_meta.locale": "us",
          "ticker_meta.market": "stocks",
          "ticker_meta.primary_exchange": "XNAS",
          "ticker_meta.ticker": "AAPL",
          "ticker_meta.ticker_root": "AAPL",
          "ticker_meta.type": "CS",
          "updated_at": "2025-04-06T04:35:40.413507Z"
        },
        "highlight": {},
        "highlights": []
      }
    ],
    "out_of": 4368670,
    "page": 1,
    "request_params": {
      "collection_name": "securities_overview",
      "per_page": 100,
      "q": "*"
    },
    "search_cutoff": false,
    "search_time_ms": 9
  },
  "message": "success"
}

Response (200 OK)

{
  "data": {
    "facet_counts": [],
    "found": 1,
    "hits": [
      {
        "document": {
          "classification.gics": "Information Technology/Technology Hardware & Equipment/Technology Hardware, Storage & Peripherals/Technology Hardware, Storage & Peripherals",
          "classification.gics_code": "45202030",
          "classification.market_sector": "Equity",
          "classification.security_description": "AAPL",
          "classification.security_type": "Common Stock",
          "classification.security_type2": "Common Stock",
          "classification.sic_code": "3571",
          "classification.sic_description": "ELECTRONIC COMPUTERS",
          "company_info.address.address1": "ONE APPLE PARK WAY",
          "company_info.address.city": "CUPERTINO",
          "company_info.address.postal_code": "95014",
          "company_info.address.state": "CA",
          "company_info.description": "Apple is among the largest companies in the world, with a broad portfolio of hardware and software products targeted at consumers and businesses.",
          "company_info.homepage_url": "https://www.apple.com",
          "company_info.list_date": "1980-12-12",
          "company_info.phone_number": "[phone]",
          "company_info.total_employees": 164000,
          "created_at": "2025-04-06T04:35:40.413507Z",
          "exchange_info.exchange_country": "USA",
          "exchange_info.exchange_name": "NASDAQ Global Select Consolidated",
          "exchange_info.mic_code": "XNAS",
          "exchange_info.openfigi_exchange_code": "US",
          "exchange_info.openfigi_ticker": "AAPL",
          "exchange_info.refinitiv_exchange_code": "NSQ",
          "exchange_info.refinitiv_exchange_name": "NASDAQ Global Select Consolidated",
          "financials.market_cap": 3327840000000,
          "financials.round_lot": 100,
          "financials.share_class_shares_outstanding": 15022070000,
          "financials.weighted_shares_outstanding": 15022073000,
          "id": "BBG000B9XRY4_XNAS",
          "identifiers.cik": "0000320193",
          "identifiers.cusip": "037833100",
          "identifiers.figi": "BBG000B9XRY4",
          "identifiers.figi_composite": "BBG000B9XRY4",
          "identifiers.figi_share_class": "BBG001S5N8V8",
          "identifiers.isin": "US0378331005",
          "identifiers.opol": "XNAS",
          "identifiers.permid": "55838974642",
          "identifiers.ric": "AAPL.O",
          "isin_history": null,
          "name": "APPLE INC",
          "status": "ACTIVE",
          "symbol": "AAPL",
          "ticker_meta.active": true,
          "ticker_meta.currency_name": "usd",
          "ticker_meta.last_updated_utc": "2025-03-26T00:00:00Z",
          "ticker_meta.locale": "us",
          "ticker_meta.market": "stocks",
          "ticker_meta.primary_exchange": "XNAS",
          "ticker_meta.ticker": "AAPL",
          "ticker_meta.ticker_root": "AAPL",
          "ticker_meta.type": "CS",
          "updated_at": "2025-04-06T04:35:40.413507Z"
        },
        "highlight": {},
        "highlights": []
      }
    ],
    "out_of": 4368670,
    "page": 1,
    "request_params": {
      "collection_name": "securities_overview",
      "per_page": 100,
      "q": "*"
    },
    "search_cutoff": false,
    "search_time_ms": 9
  },
  "message": "success"
}

Authorizations

apikey · string · query · required

Query Parameters

search · string · required

Search query (e.g., symbol)

search_type · enum<string> · required

Type of search (e.g., symbol)

Available options: symbol, identifiers.figi, identifiers.figi_composite, identifiers.figi_share_class, identifiers.isin, identifiers.opol, identifiers.cusip, identifiers.cik, exchange_info.mic_code, exchange_info.exchange_country, classification.gics_code

Response

200

application/json

Successful response

error · string | null

Error message if the request fails

message · string

Status message

data · object

Show child attributes

data. facet_counts · string[]

data. found · integer

Total number of matches found

data. hits · object[]

Show child attributes

data.hits. document · object

Show child attributes

data.hits.document. MIC · string

Market Identifier Code

data.hits.document. compositefigi · string

Composite FIGI identifier

data.hits.document. exchcode · string

Exchange code

data.hits.document. figi · string

Financial Instrument Global Identifier

data.hits.document. id · string

Unique identifier

data.hits.document. marketsector · string

Market sector (e.g., Equity)

data.hits.document. name · string

Full name of the security

data.hits.document. name2 · string

Alternate name of the security

data.hits.document. securitydescription · string

Description of the security

data.hits.document. securitytype · string

Security type

data.hits.document. securitytype2 · string

Additional security type

data.hits.document. shareclassfigi · string

Share class FIGI

data.hits.document. ticker · string

Ticker symbol

data.hits. highlight · object

Show child attributes

data.hits.highlight. ticker · object

Show child attributes

data.hits.highlight.ticker. matched_tokens · string[]

data.hits.highlight.ticker. snippet · string

data.hits. highlights · object[]

Show child attributes

data.hits.highlights. field · string

data.hits.highlights. matched_tokens · string[]

data.hits.highlights. snippet · string

data.hits. text_match · integer

data. out_of · integer

Total number of documents in the collection

data. page · integer

Current page number

data. request_params · object

Show child attributes

data.request_params. collection_name · string

data.request_params. per_page · integer

data.request_params. q · string

data. search_cutoff · boolean

Whether the search reached a cutoff

data. search_time_ms · integer

Time taken for the search in milliseconds