---
title: "Mining License Auctions"
method: GET
path: "/v2/mining/license-auctions/"
tags: ["Contracts & Licenses"]
---

# Mining License Auctions

`GET /v2/mining/license-auctions/`

Lists mining license auctions scraped from the ESDM Minerba portal. Phases and participants are omitted from list results — use the detail endpoint for the full auction record.

<Note>Available `commodity_type` values: `Nickel`, `Coal`, `Gold`, `Copper`.</Note>

Use `participant` + `qualified=true` to find auctions where a specific company passed pre-qualification.

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

## Query parameters

- `province` 'Bengkulu' | 'Gorontalo' | 'Kalimantan Tengah' | 'Maluku Utara' | 'Nusa Tenggara Barat' | 'Sulawesi Selatan' | 'Sulawesi Utara' | 'Sumatera Selatan'
- `commodity_type` 'Coal' | 'Copper' | 'Gold' | 'Nickel'
- `order_by` '-commodity_type' | '-licensed_area_ha' | '-participant_count' | '-winner_date' | 'commodity_type' | 'licensed_area_ha' | 'participant_count' | 'winner_date'
- `limit` integer
- `offset` integer
- `area_type` 'WIUP' | 'WIUPK'
- `status` string
- `participant` string
- `qualified` boolean
- `min_participants` integer

## Response `200`

Paginated list of mining license auctions.

- MiningLicenseAuctionList
  - `results` MiningLicenseAuctionListItem[], required
    - `commodity_type` string, required — Commodity type (e.g. Nickel, Coal).
    - `city` string, required — City/regency name.
    - `province` string, required — Province name.
    - `company_name` string, required — Winning company name.
    - `winner_date` string, date, nullable, required — Date winner was announced.
    - `licensed_area_ha` number, double, required — Licensed area in hectares.
    - `license_number` string, nullable, required — License number.
    - `area_type` string, required — Area type (e.g. WIUPK).
    - `kdi` string, nullable, required — KDI value.
    - `wiup_code` string, required — WIUP identification code.
    - `auction_status` string, required — Auction status (e.g. Lelang Selesai).
    - `participant_count` integer, required — Number of participants.
    - `winner` boolean, required — Whether a winner was declared.
    - `company_slug` string, nullable, required — Winning company slug.
  - `pagination` MiningLicenseAuctionListPagination, 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)