Sign in

v1

latestOpenAPI 3.0.32026-07-2664108290.0 KB
Contracts & Licenses

Mining Licenses

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

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

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

<Info>Costs 1 API credit.</Info>

get/v2/mining/licenses/

Query parameters

province'Aceh' | 'Bali' | 'Banten' | 'Bengkulu' | 'Gorontalo' | 'Jambi' | 'Jawa Barat' | 'Jawa Tengah' | 'Jawa Timur' | 'Kalimantan Barat' | 'Kalimantan Selatan' | 'Kalimantan Tengah' | 'Kalimantan Tengah, Kalimantan Timur' | 'Kalimantan Timur' | 'Kalimantan Utara' | 'Kepulauan Bangka Belitung' | 'Kepulauan Riau' | 'Lampung' | 'Maluku' | 'Maluku Utara' | 'Nusa Tenggara Barat' | 'Nusa Tenggara Timur' | 'Papua' | 'Papua Barat' | 'Papua Barat Daya' | 'Papua Tengah' | 'Riau' | 'Sulawesi Barat' | 'Sulawesi Selatan' | 'Sulawesi Tengah' | 'Sulawesi Tengah, Gorontalo, Sulawesi Utara' | 'Sulawesi Tenggara' | 'Sulawesi Utara' | 'Sumatera Barat' | 'Sumatera Selatan' | 'Sumatera Utara' | 'Yogyakarta'

Filter by province. Exact match.

commodity_type'Bauxite' | 'Clay' | 'Coal' | 'Copper' | 'Gold' | 'Granite' | 'Iron' | 'Limestone' | 'Nickel' | 'Non-Metallic Mineral' | 'Others' | 'Sand' | 'Sand, Stone, Gravel' | 'Tin'

Filter by commodity. Case-insensitive.

companystring

Filter by company slug.

order_by'-commodity_type' | '-license_effective_date' | '-license_expiry_date' | '-licensed_area_ha' | 'commodity_type' | 'license_effective_date' | 'license_expiry_date' | 'licensed_area_ha'

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

limitinteger

Number of results to return. Maximum: 30.

offsetinteger

Number of results to skip.

expiring_soonboolean

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

license_type'IPR' | 'IUP' | 'IUPK' | 'KK' | 'PKP2B' | 'SIPB'

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

activity'Eksplorasi' | 'Operasi Produksi'

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

cncboolean

Filter by Clear & Clean status. Case-insensitive.

Response

Paginated list of mining licenses.