Find Dominican fuel prices

const apiOrigin = '__API_ORIGIN__';
const params = new URLSearchParams({ fuel: 'gasoline-regular' });
const response = await fetch(`${apiOrigin}/v1/fuel-prices?${params}`);
if (!response.ok) throw new Error(`Fuel-price lookup failed: ${response.status}`);
const { prices } = await response.json();
console.log(prices);

A valid request with no price for that date returns HTTP 200 with prices: []. An unknown fuel ID returns 404. If a reliable current price is temporarily unavailable, the API returns 503.

Prices are returned as decimal strings. Keep amount as a decimal string until your application chooses how to round or calculate with it. Successful responses can be cached for up to 60 seconds, subject to the freshness of the current schedule. Do not cache errors.

Every price explains what the amount means:

• amount is the published price, and currency is DOP.
• unit is the measure used by the source. Liquid fuels use US_GALLON; natural gas may use CUBIC_METER or MMBTU.
• saleStage describes where the price applies, such as retail or station to public.
• effectiveFrom and effectiveTo are inclusive calendar dates. The schedule applies on both dates.
• deliveryMode identifies a natural-gas delivery mode (cng, lng, or traditional-pipeline). It is not another fuel ID.
• sourceUrl links to the corresponding MICM publication or historical file.

The API preserves the published unit and amount. It does not convert cubic metres to MMBtu or compare prices from different sale stages.

To find the schedule for a particular date, pass effectiveOn:

curl '__API_ORIGIN__/v1/fuel-prices?fuel=gasoline-regular&effectiveOn=2024-07-01'
curl '__API_ORIGIN__/v1/fuel-prices?fuel=natural-gas&deliveryMode=cng'

For a range of dates, use the history endpoint:

curl '__API_ORIGIN__/v1/fuel-prices/history?fuel=gasoline-regular&from=2024-01-01&to=2024-01-31&limit=100'

History returns qualified schedules whose effective periods overlap your range. If nextCursor is present, repeat the same filters with that cursor. Empty intervals do not prove that the price stayed unchanged: MICM publishes weekly resolutions, and the API does not invent values between published schedules.