Mining Sites

Lists mining sites with advanced filtering for location, commodity type, and production volume, plus sorting capabilities and detailed site information.

Available commodity_type values: Coal, Gold, Nickel, Copper.

Prefix order_by with - for descending order (e.g. -production_volume).

GET /v2/mining/sites

Mining Sites

cURL

curl --request GET \
  --url https://api.sectors.app/v2/mining/sites/ \
  --header 'Authorization: <api-key>'

200

{
  "results": [
    {
      "name": "Batubara Benhes 3",
      "project_name": "Project Alpha",
      "year": 2024,
      "commodity_type": "Coal",
      "production_volume": 1200.5,
      "unit": "Mt",
      "strip_ratio": 4.5,
      "province": "Kalimantan Timur",
      "city": "Kutai Timur",
      "company_slug": "adaro-energy",
      "company_name": "PT Adaro Energy Indonesia Tbk",
      "slug": "batubara-benhes-3"
    }
  ],
  "pagination": {
    "total_count": 1,
    "showing": 1,
    "limit": 20,
    "offset": 0,
    "has_next": false,
    "has_previous": false,
    "next_offset": null,
    "previous_offset": null
  }
}

Authorizations

ApiKeyAuthOAuthBearerAuth

Authorization · string · header · required

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

Query Parameters

province · string

Filter by exact province name (e.g., Kalimantan Timur).

commodity_type · string

Filter by commodity type. Case-insensitive.

company · string

Filter by company slug.

year · integer

Filter by reporting year.

order_by · enum<string>

Sort field. Prefix with - for descending. Default: -year.

Available options: -production_volume, -strip_ratio, -year, production_volume, strip_ratio, year

min_production · number<double>

Filter for sites with production_volume ≥ this value.

limit · integer · default: 20

Number of results to return. Maximum: 30.

offset · integer · default: 0

Number of results to skip.

Response

200

application/json

Paginated list of mining sites.

{key} · any