Sign up
All data sources

AFE Leaks

API keyafeleaks

Upstream well cost intelligence from 102k+ wells. AFE vs Actual costs, production, completions, surveys, formations, vendors, SEC XBRL financials. UPSTREAM: getCostData, getCostBreakdown, getWells (use columns param), getLocations, getProduction, getProductRevenue, getCasing, getFormations, getSurveys, getWellTests, getVendorCosts, getFiles. SEC: getFinancialSubmissions, getFinancialPresentation, getFinancialNumbers, getFinancialText, getFinancialTextBig. CONVENIENCE: getWellDetail (single API), compareCosts, searchOperators. Filters: API, operator, state, county, reservoir, lease, district, spudDate*, updateDate*, limit (max 10k), offset. Dates YYYY-MM-DD. Rate: 100 req/10s. Auth: API key (afeleaks.com).

oil-and-gas
Get this contract as JSONConnect this source →

Provenance

PublisherAFE Leaks
API basehttps://api.afeleaks.com/

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationCredentials required (API key)

Methods (20)

  • getCostData

    read

    Well-level cost summaries (AFE vs Actual capex by component).

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

    Filters: API, operator, state, county, reservoir. Aggregated per well.

  • getCostBreakdown

    read

    Line-item cost details (casing, cement, stimulation, etc.). Filters: API, operator, state, county.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

    Returns detailed cost breakdowns per well

  • getWells

    read

    Well metadata with dynamic column selection. Filters: API, operator, state, county, reservoir.

    Entitieswell
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

    columns: "API,operator,state,county,reservoir,lateral,tvd" for efficiency.

  • getLocations

    read

    Well-path/location data in WKT format (AFE Leaks). Filter by API.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

    Returns geometry_wkt field

  • getProduction

    read

    Monthly production data (oil, gas, water volumes) (AFE Leaks). Filter by API, operator, state.

    Entitiesproduction
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

    Returns oil (bbl), gas (MCF), water (bbl) by date

  • getProductRevenue

    read

    Product revenue data with well info. Returns volume, value, marketing, product type.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • getCasing

    read

    Casing design records (string type, hole size, depth, weight, grade). Filter by API.

    Entitiescompletion
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • getFormations

    read

    Formation tops and geology (reservoir name, TVD, MD). Filter by API.

    Entitiesformation
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • getSurveys

    read

    Directional survey records (MD, TVD, inclination, azimuth, DLS, N/E/VS). Filter by API.

    Entitiessurvey
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • getWellTests

    read

    Flow/pressure test data (IP rates, choke, pressures, test type) (AFE Leaks). Filter by API.

    Entitiescompletion, well
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • getVendorCosts

    read

    Vendor cost data (vendor name, code, type, cost amount, phase, rig). Filter by API, operator, state.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • getFiles

    read

    Regulatory file links and documents. Filter by API.

    Entitiesdocument
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • getFinancialSubmissions

    read

    SEC company filing metadata (AFE Leaks). Filter by cik, name, form (10-K, 10-Q), period.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "cik": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "form": {
      "type": "string"
    },
    "sic": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "tag": {
      "type": "string"
    },
    "adsh": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": true
}

  • getFinancialPresentation

    read

    Presentation/display info for financial statement elements. Filter by adsh, tag, stmt.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "cik": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "form": {
      "type": "string"
    },
    "sic": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "tag": {
      "type": "string"
    },
    "adsh": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": true
}

  • getFinancialNumbers

    read

    AFE Leaks numeric XBRL values from securities filings (value, uom, enddate).

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "cik": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "form": {
      "type": "string"
    },
    "sic": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "tag": {
      "type": "string"
    },
    "adsh": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": true
}

  • getFinancialText

    read

    AFE Leaks narrative text sections from securities filings. Filter by cik, adsh, tag.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "cik": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "form": {
      "type": "string"
    },
    "sic": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "tag": {
      "type": "string"
    },
    "adsh": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": true
}

  • getFinancialTextBig

    read

    Large text content (MD&A, footnotes) in chunks. Filter by cik, adsh, tag.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "cik": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "form": {
      "type": "string"
    },
    "sic": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "tag": {
      "type": "string"
    },
    "adsh": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "additionalProperties": true
}

  • getWellDetail

    read

    Full well detail: metadata + costs + production + cost breakdown for a single well (AFE Leaks).

    Required paramsAPI
    Entitieswell
    Input schema
    {
  "type": "object",
  "properties": {
    "API": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "required": [
    "API"
  ]
}

  • compareCosts

    unknown

    Cost comparison across operators/basins/time periods. Pass filters to scope.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "API": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "reservoir": {
      "type": "string"
    },
    "lease": {
      "type": "string"
    },
    "leaseNum": {
      "type": "string"
    },
    "wellNum": {
      "type": "string"
    },
    "district": {
      "type": "string"
    },
    "spudDateMin": {
      "type": "string"
    },
    "spudDateMax": {
      "type": "string"
    },
    "updateDateMin": {
      "type": "string"
    },
    "updateDateMax": {
      "type": "string"
    },
    "columns": {
      "type": "string"
    },
    "groupBy": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • searchOperators

    read

    Search wells by operator name. Returns well metadata with key columns.

    Required paramsoperator
    Entitiesoperator
    Input schema
    {
  "type": "object",
  "properties": {
    "operator": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "required": [
    "operator"
  ]
}