---
title: "Get commodity details by code"
method: GET
path: "/v1/commodities/{code}"
tags: ["Commodities"]
---

# Get commodity details by code

`GET /v1/commodities/{code}`

Retrieve detailed information about a specific commodity including current pricing if available

## Path parameters

- `code` string, required

## Response `200`

Commodity details

- CommodityDetailResponse
  - `status` 'success', required
  - `data` CommodityWithPrice, required
    - `code` string, required — Unique commodity identifier
    - `name` string, required — Human-readable commodity name
    - `currency` string, required — Base currency for pricing
    - `category` string, required — Commodity category
    - `description` string — Detailed description
    - `unit` string, required — Unit of measurement
    - `unit_description` string — Detailed unit description
    - `multiplier` integer — Deprecated — internal storage configuration detail retained for backward compatibility only. Do not build on it.
    - `validation` object — Deprecated — internal validation configuration retained for backward compatibility only. Do not build on it.
      - `min` number — Minimum valid price
      - `max` number — Maximum valid price
    - `price_change_threshold` number — Deprecated — internal alerting configuration retained for backward compatibility only. Do not build on it.
    - `data_source` string, nullable — Customer-safe source label; internal venue and scraper names are masked
    - `update_frequency` string, nullable — Expected source-specific refresh cadence
    - `status` 'available' | 'unavailable', required
    - `has_data` boolean, required
    - `unavailable_reason` 'never_had_data' | 'not_served' | 'withheld' | 'discontinued', nullable
    - `unavailable_detail` string, nullable
    - `sources` object[] — Per-source publication & collection metadata (#5155). What the publisher does (observation frequency, release cadence, lag, revisions) and what OilPriceAPI does (sampling frequency, backfill, ingestion latency).
      - `label` string, required — Customer-safe source label. Government/official sources are named (e.g. "EIA"); market sources render 'market_reporting'.
      - `role` string, required — Role this source plays for the commodity
      - `publication` object, required — What the publisher does — independent of OilPriceAPI
        - `cadence` string, required — How the publisher releases those observations
        - `observation_frequency` string, required — How often the underlying series has observations
        - `schedule` string, required — Plain-English publication schedule
        - `typical_lag_days` object, nullable
          - `min` integer
          - `max` integer
        - `revisions` string, nullable — Whether the publisher revises previously published periods
      - `collection` object, required — What OilPriceAPI does — sampling, backfill, ingestion
        - `frequency` string, required
        - `backfills_missed_data` boolean
        - `captures_revisions` boolean
        - `ingestion_latency` string
    - `links` Links — Canonical OilPriceAPI links for this commodity. Absolute URLs on OilPriceAPI hosts only.
      - `docs` string, uri
      - `publication_schedule` string, uri
      - `openapi` string, uri
      - `latest` string, uri
      - `historical` string, uri
    - `your_access` YourAccess — The requesting account's historical-depth entitlement for this commodity, derived from the same limit the historical price endpoints enforce — advertisement and entitlement cannot disagree.
      - `history_available_from` string, date, nullable — Earliest date this account can query; null means the full archive
      - `note` string
    - `current_price` object, nullable
      - `value` number, float
      - `formatted` string
      - `currency` string
      - `last_updated` string, date-time

## Other responses

- `404` — Commodity not found
- `500` — Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1.md) · [All operations](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oilpriceapi/oil-price-api-v1/revisions/5a5ce424cacc/schema)