Skip to main content
GET
Company Search

Overview

Search for companies using name, website or ticker. It returns a list of companies with their permalink and other attributes.

Endpoint Details

  • Method: GET
  • Endpoint: /api/enterprise/company/search

Authentication requirements

  • Include a valid JWT token in your request header
  • If you don’t have a token yet, you can get one from the /auth/token/ endpoint first.

Request

Header Parameters

Authorization
string
required
JWT token obtained from the Authentication request

URL Parameters

query
string
required
The search query string (e.g., company name, website or ticker).Examples: Tesla OR https://tesla.com OR TSLA
search_by
string
Field to search by. Supported value: name, website, ticker
company_type
string
Filter by company type. Supported values: private, public, allNote: Use all to return all types. (This is the default value is nothing is mentioned)

Response

Successful Response Fields Returns a JSON object with the following structure:
status
string
"success" if the request was processed successfully.
data
array
List of matching company objects.
count
integer
Total number of results returned.
Company Object Fields Sample Response

Authorizations

Authorization
string
header
required

JWT token obtained from the /auth/token/ endpoint.

Query Parameters

query
string
required

The search query string (e.g., company name, website or ticker).

search_by
enum<string>

Field to search by. Supported values: name, website, ticker.

Available options:
name,
website,
ticker
company_type
enum<string>
default:all

Filter by company type. Use all to return all types (default).

Available options:
private,
public,
all

Response

Search results returned successfully

status
string
Example:

"success"

data
object[]

List of matching company objects.

count
integer

Total number of results returned.

Example:

10