Company Sales Destinations

Retrieves sales destination breakdown for a specific mining company by its slug, showing revenue and volume distribution by country for a specific year. Defaults to the latest available year if none is specified.

revenue_usd is in base USD. Volume unit is specified per country entry in unit (e.g., Mt).

GET /v2/mining/sales-destination/{slug}

Company Sales Destinations

cURL

curl --request GET \
  --url https://api.sectors.app/v2/mining/sales-destination/{slug}/ \
  --header 'Authorization: <api-key>'

200

{
  "year": 2024,
  "data": {
    "China": {
      "revenue_usd": null,
      "percentage_of_total_revenue": null,
      "volume": null,
      "percentage_of_sales_volume": 16,
      "commodity_type": "Coal",
      "unit": "Mt"
    },
    "India": {
      "revenue_usd": null,
      "percentage_of_total_revenue": null,
      "volume": null,
      "percentage_of_sales_volume": 11,
      "commodity_type": "Coal",
      "unit": "Mt"
    }
  }
}

Authorizations

ApiKeyAuthOAuthBearerAuth

Authorization · string · header · required

API key passed directly in the Authorization header (without Bearer prefix).

Path Parameters

slug · string · required

The company's unique identifier slug (e.g., adaro-energy).

Query Parameters

year · integer

The year to retrieve. Defaults to the latest available year.

Response

200

application/json

Sales destination data nested by country for the requested year.

{key} · any