Benchmark Close

Enterprise benchmark-close endpoint for custom benchmark close workflows.

Sales-Gated Feature

/v1/benchmarks/close is live but not granted by a standard self-serve tier. Access is sales-gated or grandfathered. It may also be disabled by a backend feature flag. Contact support before building against it.

GET/v1/benchmarks/close

Request

curl "https://api.oilpriceapi.com/v1/benchmarks/close?benchmark=aramco&date=2026-07-15" \
  -H "Authorization: Token YOUR_API_KEY"

Parameter	Type	Required	Description
`benchmark`	string	Yes	Benchmark identifier configured for your account
`date`	date	No	Close date

Response

{
  "status": "success",
  "data": {
    "benchmark": "aramco",
    "close_date": "2026-07-15",
    "value": 74.52,
    "currency": "USD",
    "source": "custom_benchmark_close",
    "updated_at": "2026-07-15T19:30:00Z"
  }
}

Error Cases

Status	When
`400`	Missing benchmark or invalid date
`401`	Missing or invalid API key
`403`	Feature not enabled, entitlement missing, or kill-switch active
`402`	Plan/account not configured

Data Rights

Benchmark-close data can be source-sensitive. Public display, redistribution, or downstream productization requires review under the Data Usage Policy.