---
title: "Mining Licenses"
method: GET
path: "/v2/mining/licenses/"
tags: ["Contracts & Licenses"]
---

# Mining Licenses

`GET /v2/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>

## 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'
- `commodity_type` 'Bauxite' | 'Clay' | 'Coal' | 'Copper' | 'Gold' | 'Granite' | 'Iron' | 'Limestone' | 'Nickel' | 'Non-Metallic Mineral' | 'Others' | 'Sand' | 'Sand, Stone, Gravel' | 'Tin'
- `company` string
- `order_by` '-commodity_type' | '-license_effective_date' | '-license_expiry_date' | '-licensed_area_ha' | 'commodity_type' | 'license_effective_date' | 'license_expiry_date' | 'licensed_area_ha'
- `limit` integer
- `offset` integer
- `expiring_soon` boolean
- `license_type` 'IPR' | 'IUP' | 'IUPK' | 'KK' | 'PKP2B' | 'SIPB'
- `activity` 'Eksplorasi' | 'Operasi Produksi'
- `cnc` boolean

## Response `200`

Paginated list of mining licenses.

- MiningLicenseList
  - `results` MiningLicenseListItem[], required
    - `wiup_code` string, required — WIUP identification code.
    - `license_number` string, required — Official license number.
    - `license_type` string, required — License type (e.g. IUP, IUPK).
    - `province` string, required — Province name.
    - `city` string, required — City/regency name.
    - `license_effective_date` string, date, required — License start date.
    - `license_expiry_date` string, date, required — License expiry date.
    - `activity` string, required — Activity stage (e.g. Operasi Produksi).
    - `licensed_area_ha` number, double, required — Licensed area in hectares.
    - `location` string, nullable, required — Location name (e.g. city/regency).
    - `commodity_type` string, required — Commodity type.
    - `company_name` string, required — License holder company name.
    - `cnc` string, nullable, required — Clear & Clean status.
    - `generation` string, nullable, required — License generation.
    - `company_slug` string, nullable, required — Company slug.
  - `pagination` MiningLicenseListPagination, required
    - `total_count` integer, required — Total number of matching results.
    - `showing` integer, required — Number of results in this page.
    - `limit` integer, required — Maximum results per page.
    - `offset` integer, required — Number of results skipped.
    - `has_next` boolean, required — Whether a next page exists.
    - `has_previous` boolean, required — Whether a previous page exists.
    - `next_offset` integer, nullable, required — Offset for the next page, or null.
    - `previous_offset` integer, nullable, required — Offset for the previous page, or null.

## Other responses

- `400` — Invalid query parameters.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/sectors/apis/sectors-api.md) · [All operations](https://skmtc.net/sectors/apis/sectors-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sectors/sectors-api/versions/49e492f19d77/schema)