---
title: "Batch price lookup"
method: POST
path: "/v1/prices/batch"
tags: ["Prices"]
---

# Batch price lookup

`POST /v1/prices/batch`

## Request

- Base URL: `https://api.oilpriceapi.com`
- URL: `https://api.oilpriceapi.com/v1/prices/batch`
- Auth: API key in header `Authorization`

Get latest prices for multiple commodities in a single request.
Accepts up to 50 commodity codes. Counts as 1 request against your monthly quota.
Supports shorthand aliases (e.g., 'BRENT' → 'BRENT_CRUDE_USD') and case-insensitive codes.

## Request body

- object
  - `codes` string[], required

## Response `200`

Batch price data

- object
  - `status` string
  - `data` object
    - `prices` object[]
      - `code` string
      - `price` number: Actual price in commodity's currency (not cents)
      - `formatted` string
      - `currency` string
      - `unit` string
      - `updated_at` string, date-time
      - `source` string
    - `meta` object
      - `requested` integer
      - `returned` integer
      - `missing` string[], nullable
      - `timestamp` string, date-time
      - `request_id` string

## Other responses

- `400`: Invalid request (bad JSON, invalid codes, too many codes)
- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[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)