---
title: "Total Commodity Production"
method: GET
path: "/v2/mining/total-production/"
tags: ["Production & Sites"]
---

# Total Commodity Production

`GET /v2/mining/total-production/`

Returns total national production for a commodity across all years, including year-over-year percentage change. Results are ordered by year descending.

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

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

## Query parameters

- `commodity_type` 'Coal' | 'Copper' | 'Gold' | 'Nickel', required

## Response `200`

List of annual production records with year-over-year change.

- TotalProductionItem[]
  - `year` integer, required — Reporting year.
  - `production_volume` number, double, required — Total production volume.
  - `prev_year_volume` number, double, nullable, required — Previous year production volume.
  - `unit` string, required — Production unit (e.g. Mt, Kg).
  - `yoy_change_percent` number, double, nullable, required — Year-over-year change (%).

## Other responses

- `400` — `commodity_type` parameter is required.
- `404` — No production data found for the given commodity.
- `429` — Rate limit exceeded.

---

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