Scheduled Deliveries API

Pick the commodity codes you care about, a cadence and a delivery time, and OilPriceAPI emails you the prices on that schedule with a CSV attached. Nothing to host, nothing to cron.

Overview

A scheduled delivery is a standing order. You create it once; we run it. Every delivery:

• serves each code through the same selection path as GET /v1/prices/latest, so the email never disagrees with the API
• includes the change versus the previous trading session in our data
• attaches the same rows as a CSV (code, name, price, currency, unit, observed_at, previous_price, change, change_percent)
• lists any code that had no current value under a "no current price" notice instead of failing the whole run

You can also manage deliveries without code from the dashboard at oilpriceapi.com/dashboard/deliveries.

Quick Start

Create a delivery

curl -X POST https://api.oilpriceapi.com/v1/scheduled-deliveries \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "scheduled_delivery": {
      "name": "Morning desk sheet",
      "commodity_codes": ["BRENT_CRUDE_USD", "WTI_USD", "DUTCH_TTF_EUR", "EU_CARBON_EUR"],
      "cadence": "weekdays",
      "delivery_time": "07:00",
      "time_zone": "Europe/London"
    }
  }'

Response 201 Created:

{
  "data": {
    "id": "6f1c2c0e-9b1e-4f7c-9a5e-3e6f1a2b3c4d",
    "name": "Morning desk sheet",
    "commodity_codes": ["BRENT_CRUDE_USD", "WTI_USD", "DUTCH_TTF_EUR", "EU_CARBON_EUR"],
    "cadence": "weekdays",
    "weekday": null,
    "delivery_time": "07:00",
    "time_zone": "Europe/London",
    "destination": "email",
    "recipient_email": "you@example.com",
    "enabled": true,
    "source": "api",
    "deliveries_count": 0,
    "last_delivered_on": null,
    "next_delivery_at": "2026-09-28T06:00:00Z",
    "last_run": null,
    "created_at": "2026-09-25T15:04:11Z",
    "updated_at": "2026-09-25T15:04:11Z"
  },
  "message": "Scheduled. First delivery 2026-09-28T06:00:00Z."
}

Send yourself a copy right now

Useful to check the codes and the format before the first scheduled run. One manual copy per delivery every 10 minutes.

curl -X POST https://api.oilpriceapi.com/v1/scheduled-deliveries/{id}/send_now \
  -H 'Authorization: Token YOUR_API_KEY'

Response 202 Accepted:

{
  "data": { "run_id": "…", "status": "sent", "recipient": "you@example.com", "error": null },
  "message": "Sent to you@example.com."
}

Endpoints

All endpoints require an API key and are scoped to the key's account.

Fields

Read-only fields on responses: deliveries_count, last_delivered_on, next_delivery_at (UTC ISO 8601, null while paused), last_run (trigger, status, sent_at, error).

Run status

Every scheduled or manual send leaves a run record, visible as last_run:

Timing

Deliveries are dispatched every 15 minutes. A run for a given local date is created once the local clock in time_zone passes delivery_time, so a 07:00 delivery arrives between 07:00 and 07:15 local. Daylight-saving changes are handled by the zone, not by you.

The "change" column compares the served price with the last observation from an earlier calendar day. Over a weekend or holiday that is the previous trading session in our data.

Errors

Related

• Price Alerts — event-driven notifications when a price crosses a threshold
• Webhooks — push every price update to your own endpoint
• Latest prices — the endpoint each delivery row is selected through