GET
/
v2
/
companies
/
Companies V2
curl --request GET \
  --url https://api.sectors.app/v2/companies/ \
  --header 'Authorization: <authorization>'
{
    "results": [
        {
            "symbol": "BBCA.JK",
            "company_name": "Bank Central Asia Tbk"
        },
        {
            "symbol": "BBRI.JK",
            "company_name": "Bank Rakyat Indonesia (Persero) Tbk"
        }
    ],
    "pagination": {
        "total_count": 2,
        "showing": 2,
        "limit": 50,
        "offset": 0,
        "has_next": false,
        "has_previous": false,
        "next_offset": null,
        "previous_offset": null
    },
    "llm_translation": {
        "natural_query": "top 2 banks by market cap in 2024",
        "translated_params": {
            "where": "sub_sector = 'banks'",
            "order_by": "market_cap[2024]",
            "desc": true,
            "limit": 2,
            "offset": 0
        },
        "message": "Used sub_sector = 'banks' to filter for banking companies."
    }
}

{
    "results": [
        {
            "symbol": "BBCA.JK",
            "company_name": "Bank Central Asia Tbk"
        },
        {
            "symbol": "BBRI.JK",
            "company_name": "Bank Rakyat Indonesia (Persero) Tbk"
        }
    ],
    "pagination": {
        "total_count": 2,
        "showing": 2,
        "limit": 50,
        "offset": 0,
        "has_next": false,
        "has_previous": false,
        "next_offset": null,
        "previous_offset": null
    },
    "llm_translation": {
        "natural_query": "top 2 banks by market cap in 2024",
        "translated_params": {
            "where": "sub_sector = 'banks'",
            "order_by": "market_cap[2024]",
            "desc": true,
            "limit": 2,
            "offset": 0
        },
        "message": "Used sub_sector = 'banks' to filter for banking companies."
    }
}
​
Authorization
string
required
Authorization header that should be filled with your Sectors Financial API key.

​
Query Parameters

​
q
string
A natural language query (e.g., "top 10 tech companies by revenue in 2023"). When q is provided, all other query parameters (where, order_by, etc.) are ignored, as the LLM will generate them.
​
where
string
SQL-like conditions for advanced filtering. This parameter is ignored if q is present.
  • Operators: =, !=, >, >=, <, <=, like, in.
  • Logic: Combine conditions with and and or.
  • Values: Use single or double quotes for strings (e.g., sector = 'Technology'), numbers directly (e.g., market_cap > 1000000000000), and lists for the in operator (e.g., tags in ['blue-chip', 'dividend']).
Access historical or forecast data using bracket notation: field[YYYY].
Example: revenue[2023] > 100000000000 or forecast_eps_growth[2025] > 0.15.
Perform calculations within your query on both sides of a condition.
Example: revenue[2024] / total_assets[2024] > 0.5 or revenue[2024] > revenue[2023] * 1.2.
Refer to the extensive list of over 150 queryable fields in our data dictionary, covering everything from financial statements and valuation ratios to executive shareholdings and price history.
​
order_by
string
default:"symbol"
Field to sort results by (e.g., "market_cap" or "revenue[2024]"). Use a comma-separated list for multi-level sorting. This parameter is ignored if q is present.
​
desc
string
default:"false"
Sort direction for order_by. Use true for descending order. This parameter is ignored if q is present.
​
limit
integer
default:"50"
The maximum number of results to return. Max value is 200. This parameter is ignored if q is present.
​
offset
integer
default:"0"
The number of results to skip for pagination. This parameter is ignored if q is present.

​
Response

​
results
Company[]
An array of company objects matching the query.
​
pagination
object
An object containing pagination details.
​
llm_translation
object | null
Included only for natural language queries (using the q parameter). This object shows how the natural language query was translated into structured API parameters.