Skip to main content
GET
/
v2
/
mining
/
sites
Mining Sites
curl --request GET \
  --url https://api.sectors.app/v2/mining/sites/ \
  --header 'Authorization: <authorization>'
{
    "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
    }
}

​
List Mining Sites

GET /v2/mining/sites/ 
{
    "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
    }
}
​
Authorization
string
required
Authorization header that should be filled with your Sectors Financial API key.

​
Query Parameters

​
company
string
Filter by company slug.
​
province
string
Filter mining sites by exact province name (e.g., Kalimantan Timur).
​
commodity_type
string
Filter sites by commodity (e.g., Coal, Nickel, Gold, Copper). Case-insensitive.
​
year
integer
Filter by reporting year.
​
min_production
number
Filter for sites with a production volume greater than or equal to this value.
​
order_by
string
default:"-year"
Sort field. Allowed: production_volume, year, strip_ratio. Prefix with - for descending.
​
limit
integer
default:"20"
Number of results to return. Maximum value is 30.
​
offset
integer
default:"0"
Number of results to skip. Used for pagination.

​
Response

​
results
MiningSite[]
​
pagination
object

​
Mining Site Detail

GET /v2/mining/sites/{slug}/ Returns full details for a single mining site by its slug, including parsed resources/reserves and location (with lat/long). 
{
    "name": "Batubara Benhes 3",
    "project_name": "Project Alpha",
    "year": 2024,
    "commodity_type": "Coal",
    "production_volume": 1200.5,
    "unit": "Mt",
    "overburden_removal_volume": 5000.0,
    "strip_ratio": 4.17,
    "resources_reserves": [
        {
            "category": "Measured Resources",
            "volume": 50.5,
            "unit": "Mt"
        }
    ],
    "location": {
        "province": "Kalimantan Timur",
        "city": "Kutai Timur",
        "latitude": 1.234,
        "longitude": 116.567
    },
    "company_slug": "adaro-energy",
    "company_name": "PT Adaro Energy Indonesia Tbk",
    "slug": "batubara-benhes-3"
}

​
Path Parameters

​
slug
string
required
The unique identifier for the mining site.