Companies Search

Search a batch of companies' information by multiple conditions, getting the companies data with pagination information, and also be sorted by sorting by order rule provided while sending the requests.

Endpoint

POST /v1/company_report/company_search_batch

Descriptions

Batch search company information by multiple conditions with pagination and sorting, explain several attributes here:

• offset: start from which piece of data, for example default value is 0, means getting data from first one, which is used for getting data by pages. For example, if you got the pagination information in the response as below:

"pagination": {
  "total": 5059,
  "limit": 15,
  "offset": 0,
  "has_more": true
}

Which means:

• total: there are 5059 companies in total with your query condition

• limit: page size is 15, there are 15 companies in each page

• offset: getting data from first one

• has_more: 'true' value means there are more companies can be getting by changing the value of 'offset'

Parameters

Parameter	Type	Required	Description
mic	string	no	Exchange code
country_iso	string	no	Country code
market_cap_usd	object	no	Market cap range
industry_id	string	no	Industry classification ID
limit	integer	no	Page size, default value is 50
offset	integer	no	Offset, default value is 0
order	string	no	Sort order, default value is market_cap_desc

market_cap_usd

Market cap range, eg:

{ "market_cap_usd":{"min": 200, "max": 20000} }

Industory_id Options:

We support all industory id listed in below attached file.

132KB

industry Id Options.pdf

PDF

Open

Order Options:

• market_cap_desc: Market cap descending (default)

• market_cap_asc: Market cap ascending

• name_asc: Name ascending

• name_desc: Name descending

Example Request

curl -X 'POST' \
  'https://api.orbitfin.ai/v1/company_report/company_search_batch' \
  -H 'accept: application/json' \
  -H 'X-API-KEY: Bearer YOUR_API-KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "mic": "XNAS",
    "limit": 15
}
'

Example Response

{
  "status_code": 200,
  "data": {
    "companies": [
      {
        "orbit_entity_id": "1-4295914405",
        "name": "NVIDIA CORP",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/c820079af1c24e5c97dd511bcee95163.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 4595372833264.54,
        "primary_industry_id": "1-4294952838",
        "primary_business_sector_id": "1-4294952722",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "549300S4KLFTLO7GSQ80",
        "cik": "0001045810",
        "primary_isin": "US67066G1040",
        "primary_ticker": "NVDA"
      },
      {
        "orbit_entity_id": "1-4295907168",
        "name": "MICROSOFT CORP",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/a33d7aebcf9e4b3ca05ed6df6ecf4d16.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 3901297294155.35,
        "primary_industry_id": "1-4294952829",
        "primary_business_sector_id": "1-4294952830",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "INR2EJN1ERAN0W5ZP974",
        "cik": "0000789019",
        "primary_isin": "US5949181045",
        "primary_ticker": "MSFT"
      },
      {
        "orbit_entity_id": "1-4295905573",
        "name": "APPLE INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/4c894180cf354f2d88a9741e95dcd914.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 3829711116721.92,
        "primary_industry_id": "1-4294952719",
        "primary_business_sector_id": "1-4294952722",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "HWUPKR0MPOU8FGXBT394",
        "cik": "0000320193",
        "primary_isin": "US0378331005",
        "primary_ticker": "AAPL"
      },
      {
        "orbit_entity_id": "1-5030853586",
        "name": "ALPHABET INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/09a374be04cf4e9f97e31be50419f49e.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 2959525244490.64,
        "primary_industry_id": "1-4294952829",
        "primary_business_sector_id": "1-4294952830",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "5493006MHB84DD0ZWV18",
        "cik": "0001652044",
        "primary_isin": "US02079K1079",
        "primary_ticker": "GOOG"
      },
      {
        "orbit_entity_id": "1-4295905494",
        "name": "AMAZON.COM INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/268202bd5a4d449198c3fabe2ddc12bb.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 2401951492052.31,
        "primary_industry_id": "1-4294952800",
        "primary_business_sector_id": "1-4294952903",
        "primary_economic_sector_id": "1-4294952746",
        "lei": "ZXTILKJKG63JELOEG630",
        "cik": "0001018724",
        "primary_isin": "US0231351067",
        "primary_ticker": "AMZN"
      },
      {
        "orbit_entity_id": "1-4297297477",
        "name": "META PLATFORMS INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/017d16aeb1ea448bab6adfcd796dc8e9.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 1803187134113.72,
        "primary_industry_id": "1-4294952829",
        "primary_business_sector_id": "1-4294952830",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "BQ4BKCS1HXDV9HN80Z93",
        "cik": "0001326801",
        "primary_isin": "US30303M1027",
        "primary_ticker": "META"
      },
      {
        "orbit_entity_id": "1-5060689053",
        "name": "BROADCOM INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/c735b5120c794d36a7ccbcf9ab6a0f34.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 1631577206237.76,
        "primary_industry_id": "1-4294952838",
        "primary_business_sector_id": "1-4294952722",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "549300WV6GIDOZJTV909",
        "cik": "0001730168",
        "primary_isin": "US11135F1012",
        "primary_ticker": "AVGO"
      },
      {
        "orbit_entity_id": "1-5088024644",
        "name": "TESLA INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/6babe3311a6d42b88c0a77a08ed6a8d7.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 1458710426732.42,
        "primary_industry_id": "1-4294952930",
        "primary_business_sector_id": "1-4294952931",
        "primary_economic_sector_id": "1-4294952746",
        "lei": "54930043XZGB27CTOV49",
        "cik": "0001318605",
        "primary_isin": "US88160R1014",
        "primary_ticker": "TSLA"
      },
      {
        "orbit_entity_id": "1-4295902158",
        "name": "NETFLIX INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/79758b879ba34eb380759efab4c96d12.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 515966822272.59,
        "primary_industry_id": "1-4294952829",
        "primary_business_sector_id": "1-4294952830",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "549300Y7VHGU0I7CE873",
        "cik": "0001065280",
        "primary_isin": "US64110L1061",
        "primary_ticker": "NFLX"
      },
      {
        "orbit_entity_id": "1-4295968965",
        "name": "PALANTIR TECHNOLOGIES INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/0d30db1386b041dbae70cd3fb0b55e28.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 435467547382.56,
        "primary_industry_id": "1-4294952829",
        "primary_business_sector_id": "1-4294952830",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "549300UVN46B3BBDHO85",
        "cik": "0001321655",
        "primary_isin": "US69608A1088",
        "primary_ticker": "PLTR"
      },
      {
        "orbit_entity_id": "1-4295912987",
        "name": "COSTCO WHOLESALE CORP",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/bdb98b8512ef45c1b9d54498557784d9.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 405692828559,
        "primary_industry_id": "1-4294952800",
        "primary_business_sector_id": "1-4294952903",
        "primary_economic_sector_id": "1-4294952746",
        "lei": "29DX7H14B9S6O3FD6V18",
        "cik": "0000909832",
        "primary_isin": "US22160K1051",
        "primary_ticker": "COST"
      },
      {
        "orbit_entity_id": "1-4295903297",
        "name": "ADVANCED MICRO DEVICES INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/4014faab778949c185d2f5cd1b35403b.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 382277063821.87,
        "primary_industry_id": "1-4294952838",
        "primary_business_sector_id": "1-4294952722",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "R2I72C950HOYXII45366",
        "cik": "0000002488",
        "primary_isin": "US0079031078",
        "primary_ticker": "AMD"
      },
      {
        "orbit_entity_id": "1-4295884869",
        "name": "ASML HOLDING NV",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/b7f45792646246f5960cc3f32e2d328d.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 288166042766.79,
        "primary_industry_id": "1-4294952838",
        "primary_business_sector_id": "1-4294952722",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "724500Y6DUVHQD6OXN27",
        "cik": "0000937966",
        "primary_isin": "USN070592100",
        "primary_ticker": "ASML"
      },
      {
        "orbit_entity_id": "1-5080018615",
        "name": "CISCO SYSTEMS INC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/e89318aafe1d4435b407208f652f0df2.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 278028348980.94,
        "primary_industry_id": "1-4294952721",
        "primary_business_sector_id": "1-4294952722",
        "primary_economic_sector_id": "1-4294952723",
        "lei": "549300LKFJ962MZ46593",
        "cik": "0000858877",
        "primary_isin": "US17275R1023",
        "primary_ticker": "CSCO"
      },
      {
        "orbit_entity_id": "1-4295894341",
        "name": "ASTRAZENECA PLC",
        "png_logo_path": "https://ot-cdn.s3.us-west-2.amazonaws.com/company-logos/v1/bfc127ec82d745fcaca30399d90fb8bb.png",
        "country_iso": "US",
        "mic": "XNAS",
        "market_cap_usd": 266000191103.84,
        "primary_industry_id": "1-4294952844",
        "primary_business_sector_id": "1-4294952845",
        "primary_economic_sector_id": "1-4294952853",
        "lei": "PY6ZZQWO2IZFZC3IOL08",
        "cik": "0000901832",
        "primary_isin": "US0463531089",
        "primary_ticker": "AZN"
      }
    ],
    "pagination": {
      "total": 5059,
      "limit": 15,
      "offset": 0,
      "has_more": true
    }
  },
  "message": "Batch search successful"
}

Error Code

Code	Description
400	Insufficient user balance.
401	Unauthorized access. Invalid API key.

Billing Rules

• Use limit parameter to control query size

• Batch Billing‌: Every 20 data records count as 1 billing unit (rounded up if not a full 20)

• ‌Tiered Calculation‌: Billing units = ceil(limit / 20)

Billing Examples‌

Records	Billing Units	Formula
1-20	1	ceil(20/20)
21-40	2	ceil(40/20)
100	5	ceil(100/20)
105	6	ceil(105/20)