Bulk Entity Lookup

Search for multiple companies with advanced filters.

Endpoint

POST /companies/search/bulk

Parameters

Parameter	Type	Required	Description
exchange	string[]	No	Stock exchange codes (e.g., ["NYSE", "NASDAQ"])
country	string[]	No	ISO country codes (e.g., ["US", "GB"])
market_cap	object	No	Market cap range {"min": 1000000000, "max": 100000000000}
industry	string[]	No	GICS industry classifications
limit	integer	No	Number of results (default: 20, max: 100)
offset	integer	No	Pagination offset (default: 0)
order	string	No	Sort order: market_cap_desc, market_cap_asc, name_asc

Example Request

bash

curl -X POST "https://api.orbitfin.ai/v1/companies/search/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": ["US"],
    "market_cap": {"min": 100000000000},
    "industry": ["Software"],
    "limit": 20,
    "order": "market_cap_desc"
  }'

Response

json

{
  "status": "success",
  "credits_used": 1.0,
  "data": {
    "total_count": 156,
    "returned_count": 20,
    "companies": [
      {
        "orbit_entity_id": "ent_7kms9p2w",
        "company_name": "Microsoft Corporation",
        "ticker": "MSFT",
        "market_cap": 2890000000000
      }
    ]
  }
}