Upstream API Client Interface

Filter and download oil & gas well data, locations, and cost information

API Access Required

This interface requires an account with API privileges. If you don't have access, please view our plans or contact us to upgrade your account.

API Endpoint
Location Filters
Well Filters
Cost Filters
Range Filters
Perf Interval (ft) -
First Prod Year -
Spud Date -
AFE Date -
Product Filters
Product
Date Range -
Value ($) -
Volume -
0 records returned

Export to CSV

Download matching records as a CSV file. Exports stop automatically when your remaining monthly quota is reached.

Preparing export...

Bulk Table Downloads

Pull entire tables as .csv.gz snapshots. Files are pre-generated nightly and served from object storage, so large downloads don't count against your API call quota or hit the request timeout. Available to Enterprise and legacy-unlimited API plans only.

Loading snapshot manifest…

Bulk Table Downloads — v2 (Full Universe, per state)

Same delivery mechanism as the v1 bulk downloads above, but each file covers an entire state across the full ~770K-well universe (not just cost-data wells). Each state ships as a single zip containing wells, permits, production, casing, surveys, formations, file links, and locations. Texas raw lease-level production also ships as 13 per-RRC-district .csv.gz files alongside the state zip — listed under "+ production-raw". Weekly refresh; permits regenerate nightly.

Loading v2 manifest…

Data Preview