Skip to main content
GET
/
v2
/
mining
/
companies
List Mining Companies
curl --request GET \
  --url https://api.sectors.app/v2/mining/companies/ \
  --header 'Authorization: <api-key>'
{
  "results": [
    {
      "slug": "adaro-andalan-indonesia",
      "name": "PT Adaro Andalan Indonesia Tbk",
      "idx_ticker": "AADI.JK",
      "company_type": "Holding",
      "key_operation": "Coal Trading",
      "commodity_type": [
        "Coal"
      ]
    }
  ],
  "pagination": {
    "total_count": 1,
    "showing": 1,
    "limit": 20,
    "offset": 0,
    "has_next": false,
    "has_previous": false,
    "next_offset": null,
    "previous_offset": null
  }
}

Authorizations

Authorization
string
header
required

API key passed directly in the Authorization header (without Bearer prefix).

Query Parameters

commodity_type
string

Filter by commodity. E.g. Coal, Nickel, Gold.

limit
integer
default:20

Results per page. Default 20.

offset
integer
default:0

Items to skip for pagination.

keyword
string

Search across company name, IDX ticker, slug, and key operations (case-insensitive).

company_type
string

Filter by company type. E.g. Holding, Subsidiary.

has_financials
boolean

If true, return only companies with financial data available.

Response

Paginated list of mining companies.

{key}
any