Mining Licenses

Lists mining licenses (IUP/IUPK) from the ESDM Minerba portal with filters for status, commodity, location, and expiry date.

Top commodity_type values: Coal, Nickel, Non-Metallic Mineral, Sand/Stone/Gravel, Limestone, Gold, Tin, Iron, Bauxite, Clay, Copper.

Prefix order_by with - for descending order. Default sort: license_expiry_date (soonest expiring first).

GET /v2/mining/licenses

Mining Licenses

cURL

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

200

{
  "results": [
    {
      "wiup_code": "3411003442014022",
      "license_number": "503/1573/IUP-OP/BPPMD-PTSP/X/2015",
      "license_type": "IUP",
      "province": "Kalimantan Timur",
      "city": "Paser",
      "license_effective_date": "2015-10-02",
      "license_expiry_date": "2025-10-02",
      "activity": "Operasi Produksi",
      "licensed_area_ha": 1500.5,
      "location": {
        "type": "Point",
        "coordinates": [
          116.123,
          -1.456
        ]
      },
      "commodity_type": "Coal",
      "company_name": "PT Jasa Tambang Nusantara",
      "cnc": "CnC",
      "generation": null,
      "company_slug": "jasa-tambang-nusantara"
    }
  ],
  "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 province. Exact match.

commodity_type · string

Filter by commodity. Case-insensitive.

company · string

Filter by company slug.

order_by · enum<string>

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

Available options: -commodity_type, -license_effective_date, -license_expiry_date, -licensed_area_ha, commodity_type, license_effective_date, license_expiry_date, licensed_area_ha

limit · integer · default: 20

Number of results to return. Maximum: 30.

offset · integer · default: 0

Number of results to skip.

expiring_soon · boolean

Set to true to find licenses expiring within the next 365 days.

license_type · string

Filter by license type (e.g., IUP, IUPK). Case-insensitive.

activity · string

Filter by activity stage (e.g., Eksplorasi, Operasi Produksi). Case-insensitive.

cnc · boolean

Filter by Clear & Clean status. Case-insensitive.

Response

200

application/json

Paginated list of mining licenses.

{key} · any