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.