---
title: "Get the data sources and methodology table"
method: GET
path: "/v1/meta/methodology"
tags: ["Commodities"]
---

# Get the data sources and methodology table

`GET /v1/meta/methodology`

## Request

- Base URL: `https://api.oilpriceapi.com`
- URL: `https://api.oilpriceapi.com/v1/meta/methodology`
- Auth: none required

One row per catalogue code with its source label, instrument type,
update frequency, publication cadence, nominal stale threshold, source
timezone, front-month roll rule and revision policy (spec T3).

Generated from the same catalogue, source-cadence registry, freshness
and futures-contract code the API serves from, so it cannot drift from
API behaviour. A fact the metadata does not hold reads "not recorded";
it is never estimated. Source labels name government publishers and
render `market_reporting` for every other source. OilPriceAPI grants no
rights in any data.

Takes the same listing parameters as GET /v1/commodities. Keyless and
cached for an hour.

## Query parameters

- `include_unavailable` boolean
- `include_discontinued` boolean

## Response `200`

Methodology rows and their coverage

- object
  - `status` string
  - `data` object
    - `codes` object[]
      - `code` string
      - `source` unknown
      - `instrument_type` string
      - `update_frequency` string
      - `publication_cadence` unknown
      - `stale_threshold` unknown
      - `timezone` string
      - `roll_rule` string: Object for front-month benchmarks, "not applicable" for non-futures, otherwise "not recorded".
      - `revision_policy` string
    - `coverage` object
      - `codes` integer
      - `source_type_cadence_complete` integer
      - `recorded` object
  - `meta` object
    - `timestamps_timezone` string
    - `not_recorded_value` string

## Other responses

- `429`: Rate limited by IP. Honour Retry-After.
- `500`: Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

## Changes

- **2026-10-17** `d83e7b18c195`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/changes/v1/meta/methodology/get.md)

---

[API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) - [All operations](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/revisions/7f8b4d763210?raw)