v1

latestOpenAPI 3.0.32026-07-2664108290.0 KB
Contracts & Licenses

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>

get/v2/mining/license-auctions/

Query parameters

province'Bengkulu' | 'Gorontalo' | 'Kalimantan Tengah' | 'Maluku Utara' | 'Nusa Tenggara Barat' | 'Sulawesi Selatan' | 'Sulawesi Utara' | 'Sumatera Selatan'

Filter by province (e.g., Sulawesi Selatan). Case-insensitive.

commodity_type'Coal' | 'Copper' | 'Gold' | 'Nickel'

Filter by commodity (e.g., Nickel, Coal). Case-insensitive.

order_by'-commodity_type' | '-licensed_area_ha' | '-participant_count' | '-winner_date' | 'commodity_type' | 'licensed_area_ha' | 'participant_count' | 'winner_date'

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

limitinteger

Number of results to return. Maximum: 30.

offsetinteger

Number of results to skip.

area_type'WIUP' | 'WIUPK'

Filter by area type (e.g., WIUPK). Case-insensitive.

statusstring

Filter by auction status (e.g., Lelang Selesai). Case-insensitive.

participantstring

Filter auctions where a company name (partial match) participated.

qualifiedboolean

When true, only return auctions where the participant passed qualification. Requires participant.

min_participantsinteger

Only return auctions with at least this many participants.

Response

Paginated list of mining license auctions.