{"openapi":"3.1.0","info":{"title":"Petrora API","version":"1","description":"Texas oil and gas records from the Railroad Commission and TexNet, cleaned, joined, and served as JSON. Every row that names an entity carries a `url` to its petrora.com page; cite it. Every call needs an account: an API key or a session token as a bearer. Heavy aggregates are precomputed nightly, so reads are fast but a figure can be up to a day old; each says when it was computed. Windows on permits are on the day a permit first appeared in daily files. Production lags the reporting month by two to three months and is reported by lease, never by well.","contact":{"name":"Petrora","email":"contact@petrora.com","url":"https://petrora.com"}},"servers":[{"url":"https://api.petrora.com","description":"Production"}],"tags":[{"name":"Stats"},{"name":"Permits"},{"name":"Wells"},{"name":"Counties"},{"name":"Basins"},{"name":"Fields"},{"name":"Map"},{"name":"Account"},{"name":"Operators"},{"name":"Formations"},{"name":"Leases"},{"name":"Water"},{"name":"Earthquakes"},{"name":"Account","description":"Bearer token required."},{"name":"Watchlists","description":"Saved permit searches with an optional daily email. The paths say alerts for historical reasons. Bearer token required except where noted."}],"externalDocs":{"url":"https://petrora.com/guides/api-reference","description":"The written reference: what each field means and where it comes from."},"components":{"securitySchemes":{"apiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"pk_live_…","description":"An API key from your account page, sent as a bearer token. Keys belong to an account on a free trial or a paid plan; calls are metered against it."},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"The session token of a petrora.com sign-in, sent as a bearer token. A free account is enough for CSV downloads and watchlists."}},"schemas":{"Stats":{"type":"object","properties":{"permits":{"type":"number"},"wellbores":{"type":"number"},"completions":{"type":"number"},"productionRecords":{"type":"number"},"productionRecordsApprox":{"type":"boolean","enum":[true]},"formationTops":{"type":"number"},"injectionPermits":{"type":"number"},"injectionRecords":{"type":"number"},"injectionRecordsApprox":{"type":"boolean","enum":[true]},"earthquakes":{"type":"number"},"operators":{"type":"number"},"counties":{"type":"number"},"earliestPermit":{"type":["string","null"]},"permitsLast30d":{"type":"number"},"asOf":{"type":"string"}},"required":["permits","wellbores","completions","productionRecords","productionRecordsApprox","formationTops","injectionPermits","injectionRecords","injectionRecordsApprox","earthquakes","operators","counties","earliestPermit","permitsLast30d","asOf"]},"Permit":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":"number"},"apiNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"district":{"type":["number","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"isHorizontal":{"type":["boolean","null"]},"dateIssued":{"type":["string","null"]},"firstSeenAt":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","permitNumber","apiNumber","countyName","district","operatorNumber","operatorName","leaseName","wellNumber","totalDepth","isHorizontal","dateIssued","firstSeenAt","latitude","longitude","url"]},"Permits":{"type":"object","properties":{"query":{"type":"object","additionalProperties":{},"description":"The parsed query, with defaults applied."},"count":{"type":"number","description":"Rows in this response."},"total":{"type":"number","description":"Rows matching before limit and offset."},"permits":{"type":"array","items":{"$ref":"#/components/schemas/Permit"}}},"required":["query","count","total","permits"]},"Error":{"type":"object","properties":{"error":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}],"description":"A message, or per-field messages for a bad query."},"hint":{"type":"string"}},"required":["error"]},"PermitDetail":{"type":"object","properties":{"permit":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":"number"},"sequenceNumber":{"type":"number"},"applicationType":{"type":["string","null"]},"otherExplanation":{"type":["string","null"]},"apiNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"countyCode":{"type":["number","null"]},"district":{"type":["number","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"wellStatus":{"type":["string","null"]},"cancellationReason":{"type":["string","null"]},"isHorizontal":{"type":["boolean","null"]},"isDirectional":{"type":["boolean","null"]},"isSidetrack":{"type":["boolean","null"]},"dateReceived":{"type":["string","null"]},"dateIssued":{"type":["string","null"]},"dateAmended":{"type":["string","null"]},"dateExtended":{"type":["string","null"]},"dateSpud":{"type":["string","null"]},"dateSurfaceCasing":{"type":["string","null"]},"dateCancelled":{"type":["string","null"]},"dateExpired":{"type":["string","null"]},"dateWellStatus":{"type":["string","null"]},"dateFinalUpdate":{"type":["string","null"]},"firstSeenAt":{"type":["string","null"]},"surfaceSection":{"type":["string","null"]},"surfaceBlock":{"type":["string","null"]},"surfaceSurvey":{"type":["string","null"]},"surfaceAbstract":{"type":["string","null"]},"surfaceAcres":{"type":["number","null"]},"surfaceNearestCity":{"type":["string","null"]},"surfaceMilesFromCity":{"type":["number","null"]},"surfaceDirectionFromCity":{"type":["string","null"]},"nearestLeaseLine":{"type":["number","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"wellUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","permitNumber","sequenceNumber","applicationType","otherExplanation","apiNumber","countyName","countyCode","district","operatorNumber","operatorName","leaseName","wellNumber","totalDepth","wellStatus","cancellationReason","isHorizontal","isDirectional","isSidetrack","dateReceived","dateIssued","dateAmended","dateExtended","dateSpud","dateSurfaceCasing","dateCancelled","dateExpired","dateWellStatus","dateFinalUpdate","firstSeenAt","surfaceSection","surfaceBlock","surfaceSurvey","surfaceAbstract","surfaceAcres","surfaceNearestCity","surfaceMilesFromCity","surfaceDirectionFromCity","nearestLeaseLine","latitude","longitude","url","wellUrl","operatorUrl"]},"versions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":"number"},"sequenceNumber":{"type":"number"},"applicationType":{"type":["string","null"]},"otherExplanation":{"type":["string","null"]},"apiNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"countyCode":{"type":["number","null"]},"district":{"type":["number","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"wellStatus":{"type":["string","null"]},"cancellationReason":{"type":["string","null"]},"isHorizontal":{"type":["boolean","null"]},"isDirectional":{"type":["boolean","null"]},"isSidetrack":{"type":["boolean","null"]},"dateReceived":{"type":["string","null"]},"dateIssued":{"type":["string","null"]},"dateAmended":{"type":["string","null"]},"dateExtended":{"type":["string","null"]},"dateSpud":{"type":["string","null"]},"dateSurfaceCasing":{"type":["string","null"]},"dateCancelled":{"type":["string","null"]},"dateExpired":{"type":["string","null"]},"dateWellStatus":{"type":["string","null"]},"dateFinalUpdate":{"type":["string","null"]},"firstSeenAt":{"type":["string","null"]},"surfaceSection":{"type":["string","null"]},"surfaceBlock":{"type":["string","null"]},"surfaceSurvey":{"type":["string","null"]},"surfaceAbstract":{"type":["string","null"]},"surfaceAcres":{"type":["number","null"]},"surfaceNearestCity":{"type":["string","null"]},"surfaceMilesFromCity":{"type":["number","null"]},"surfaceDirectionFromCity":{"type":["string","null"]},"nearestLeaseLine":{"type":["number","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}},"required":["id","permitNumber","sequenceNumber","applicationType","otherExplanation","apiNumber","countyName","countyCode","district","operatorNumber","operatorName","leaseName","wellNumber","totalDepth","wellStatus","cancellationReason","isHorizontal","isDirectional","isSidetrack","dateReceived","dateIssued","dateAmended","dateExtended","dateSpud","dateSurfaceCasing","dateCancelled","dateExpired","dateWellStatus","dateFinalUpdate","firstSeenAt","surfaceSection","surfaceBlock","surfaceSurvey","surfaceAbstract","surfaceAcres","surfaceNearestCity","surfaceMilesFromCity","surfaceDirectionFromCity","nearestLeaseLine","latitude","longitude"]},"description":"Every sequence of the permit, amendments included."},"applications":{"type":"array","items":{"type":"object","properties":{"statusNumber":{"type":["string","null"]},"statusSequenceNumber":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"dateAppReceived":{"type":["string","null"]},"applicationStatus":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]}},"required":["statusNumber","statusSequenceNumber","operatorNumber","operatorName","dateAppReceived","applicationStatus","leaseName","wellNumber"]}}},"required":["permit","versions","applications"]},"WellsListRow":{"type":"object","properties":{"apiNumber":{"type":"string"},"countyName":{"type":["string","null"]},"district":{"type":["number","null"]},"leaseName":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"permitCount":{"type":"number"},"maxDepth":{"type":["number","null"]},"lastIssued":{"type":["string","null"]},"hasProduction":{"type":"boolean"},"lastProductionDate":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["apiNumber","countyName","district","leaseName","operatorNumber","operatorName","permitCount","maxDepth","lastIssued","hasProduction","lastProductionDate","url","operatorUrl"]},"WellsList":{"type":"object","properties":{"query":{"type":"object","additionalProperties":{}},"total":{"type":"number"},"rows":{"type":"array","items":{"$ref":"#/components/schemas/WellsListRow"}}},"required":["query","total","rows"]},"Well":{"type":"object","properties":{"well":{"type":"object","properties":{"apiNumber":{"type":"string"},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"permitOperatorNumber":{"type":["number","null"]},"permitOperatorName":{"type":["string","null"]},"operatorChanged":{"type":"boolean"},"countyName":{"type":["string","null"]},"district":{"type":["number","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"fieldName":{"type":["string","null"]},"wellTypeName":{"type":["string","null"]},"onSchedule":{"type":["string","null"]},"p5OrgStatus":{"type":["string","null"]},"wellStatus":{"type":["string","null"]},"completionDate":{"type":["string","null"]},"shutInDate":{"type":["string","null"]},"plugDate":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"isHorizontal":{"type":"boolean"},"isDirectional":{"type":"boolean"},"isSidetrack":{"type":"boolean"},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"permitCount":{"type":"number"},"firstPermitDate":{"type":["string","null"]},"lastPermitDate":{"type":["string","null"]},"hasEwa":{"type":"boolean"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["apiNumber","operatorNumber","operatorName","permitOperatorNumber","permitOperatorName","operatorChanged","countyName","district","leaseName","wellNumber","fieldName","wellTypeName","onSchedule","p5OrgStatus","wellStatus","completionDate","shutInDate","plugDate","totalDepth","isHorizontal","isDirectional","isSidetrack","latitude","longitude","permitCount","firstPermitDate","lastPermitDate","hasEwa","url","operatorUrl"]},"permits":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":"number"},"permitSequenceNumber":{"type":"number"},"applicationType":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"dateReceived":{"type":["string","null"]},"dateIssued":{"type":["string","null"]},"dateSpud":{"type":["string","null"]},"wellStatus":{"type":["string","null"]},"isHorizontal":{"type":["boolean","null"]},"isSidetrack":{"type":["boolean","null"]},"firstSeenAt":{"type":["string","null"]}},"required":["id","permitNumber","permitSequenceNumber","applicationType","operatorNumber","operatorName","leaseName","wellNumber","totalDepth","dateReceived","dateIssued","dateSpud","wellStatus","isHorizontal","isSidetrack","firstSeenAt"]}},"completions":{"type":"array","items":{"type":"object","properties":{"oilGasCode":{"type":["string","null"]},"districtNo":{"type":["string","null"]},"leaseNo":{"type":["string","null"]},"wellNo":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"fieldName":{"type":["string","null"]},"operatorNumber":{"type":["string","null"]},"operatorName":{"type":["string","null"]},"completionDate":{"type":["string","null"]},"shutInDate":{"type":["string","null"]},"statusDesc":{"type":["string","null"]},"totalDepth":{"type":["number","null"]}},"required":["oilGasCode","districtNo","leaseNo","wellNo","leaseName","fieldName","operatorNumber","operatorName","completionDate","shutInDate","statusDesc","totalDepth"]}},"custody":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"fromPeriod":{"type":"number"},"toPeriod":{"type":"number"},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","fromPeriod","toPeriod","operatorUrl"]},"description":"Every operator that reported production on the well's lease, in order; periods are YYYYMM integers."},"production":{"type":["object","null"],"properties":{"hasProduction":{"type":"boolean"},"firstProductionDate":{"type":["string","null"]},"lastProductionDate":{"type":["string","null"]},"cumOilBbl":{"type":["number","null"]},"cumGasMcf":{"type":["number","null"]},"recentOilBbl":{"type":["number","null"]},"priorOilBbl":{"type":["number","null"]}},"required":["hasProduction","firstProductionDate","lastProductionDate","cumOilBbl","cumGasMcf","recentOilBbl","priorOilBbl"]},"elevationFt":{"type":["number","null"]},"tops":{"type":"array","items":{"type":"object","properties":{"formationName":{"type":"string"},"canonicalName":{"type":["string","null"]},"canonicalSlug":{"type":["string","null"]},"depthFt":{"type":["number","null"]},"subseaFt":{"type":["number","null"]}},"required":["formationName","canonicalName","canonicalSlug","depthFt","subseaFt"]}},"perforations":{"type":"array","items":{"type":"object","properties":{"fromDepth":{"type":["number","null"]},"toDepth":{"type":["number","null"]},"openHole":{"type":"boolean"}},"required":["fromDepth","toDepth","openHole"]}},"casing":{"type":"array","items":{"type":"object","properties":{"casingIn":{"type":["number","null"]},"depthSet":{"type":["number","null"]},"cementSacks":{"type":["number","null"]},"cementUnit":{"type":["string","null"]},"holeIn":{"type":["number","null"]}},"required":["casingIn","depthSet","cementSacks","cementUnit","holeIn"]}},"injection":{"type":["object","null"],"properties":{"permits":{"type":"array","items":{"type":"object","properties":{"uicNumber":{"type":"string"},"kind":{"type":"string"},"activated":{"type":"boolean"},"permittedBblPerDay":{"type":["number","null"]},"maxPressurePsi":{"type":["number","null"]},"topZone":{"type":["number","null"]},"botZone":{"type":["number","null"]},"canceledDate":{"type":["string","null"]},"pluggedDate":{"type":["string","null"]}},"required":["uicNumber","kind","activated","permittedBblPerDay","maxPressurePsi","topZone","botZone","canceledDate","pluggedDate"]}},"injectedTotalBbl":{"type":"number"},"injectedLast12Bbl":{"type":"number"},"reportedThrough":{"type":["string","null"]},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"bbl":{"type":"number"}},"required":["month","bbl"]}}},"required":["permits","injectedTotalBbl","injectedLast12Bbl","reportedThrough","monthly"]},"seismicity":{"type":["object","null"],"properties":{"count":{"type":"number"},"maxMagnitude":{"type":["number","null"]},"radiusKm":{"type":"number"},"days":{"type":"number"}},"required":["count","maxMagnitude","radiusKm","days"]},"reconciliation":{"type":["object","null"],"properties":{"bestOperatorNumber":{"type":["number","null"]},"bestOperatorName":{"type":["string","null"]},"bestSource":{"type":["string","null"]},"ewaOperatorNumber":{"type":["number","null"]},"ewaOperatorName":{"type":["string","null"]},"prodOperatorNumber":{"type":["number","null"]},"prodOperatorName":{"type":["string","null"]},"prodReportPeriod":{"type":["number","null"]},"permitOperatorNumber":{"type":["number","null"]},"permitOperatorName":{"type":["string","null"]},"permitDate":{"type":["string","null"]},"ewaProdMismatch":{"type":"boolean"},"ewaPermitMismatch":{"type":"boolean"}},"required":["bestOperatorNumber","bestOperatorName","bestSource","ewaOperatorNumber","ewaOperatorName","prodOperatorNumber","prodOperatorName","prodReportPeriod","permitOperatorNumber","permitOperatorName","permitDate","ewaProdMismatch","ewaPermitMismatch"]},"filings":{"type":"array","items":{"type":"object","properties":{"apiSuffix":{"type":["string","null"]},"filedDate":{"type":["string","null"]},"w2g1Date":{"type":["string","null"]},"hasLogRef":{"type":"boolean"}},"required":["apiSuffix","filedDate","w2g1Date","hasLogRef"]}},"offsetWells":{"type":"array","items":{"type":"object","properties":{"apiNumber":{"type":"string"},"distanceKm":{"type":"number"},"leaseName":{"type":["string","null"]},"operatorName":{"type":["string","null"]},"elevationFt":{"type":["number","null"]},"tops":{"type":"array","items":{"type":"object","properties":{"formationName":{"type":"string"},"canonicalName":{"type":["string","null"]},"canonicalSlug":{"type":["string","null"]},"depthFt":{"type":["number","null"]},"subseaFt":{"type":["number","null"]}},"required":["formationName","canonicalName","canonicalSlug","depthFt","subseaFt"]}},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["apiNumber","distanceKm","leaseName","operatorName","elevationFt","tops","url"]}},"sectors":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"shortName":{"type":["string","null"]},"confidence":{"type":["string","null"]},"source":{"type":["string","null"]}},"required":["slug","name","shortName","confidence","source"]}},"leases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"oilGasCode":{"type":"string"},"districtNo":{"type":"number"},"leaseNo":{"type":"number"},"leaseName":{"type":["string","null"]},"fieldName":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"wellCount":{"type":"number"},"totalOilBbl":{"type":"number"},"totalGasMcf":{"type":"number"},"firstProduction":{"type":["string","null"]},"lastProduction":{"type":["string","null"]},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","url","oilGasCode","districtNo","leaseNo","leaseName","fieldName","operatorNumber","operatorName","wellCount","totalOilBbl","totalGasMcf","firstProduction","lastProduction","operatorUrl"]}},"operatorP5":{"type":["object","null"],"properties":{"city":{"type":["string","null"]},"stateCode":{"type":["string","null"]},"phone":{"type":["string","null"]},"p5Status":{"type":["string","null"]},"p5FiledDate":{"type":["string","null"]},"totalPermits":{"type":["number","null"]}},"required":["city","stateCode","phone","p5Status","p5FiledDate","totalPermits"]},"monthlyProduction":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"oilBbl":{"type":"number"},"gasMcf":{"type":"number"}},"required":["month","oilBbl","gasMcf"]},"description":"Lease totals for the leases this well is completed on, 36 months."},"productionReportedThrough":{"type":["string","null"]},"briefing":{"type":"array","items":{"type":"string"}}},"required":["well","permits","completions","custody","production","elevationFt","tops","perforations","casing","injection","seismicity","reconciliation","filings","offsetWells","sectors","leases","operatorP5","monthlyProduction","productionReportedThrough","briefing"]},"CrossSection":{"type":"object","properties":{"wells":{"type":"array","items":{"type":"object","properties":{"apiNumber":{"type":"string"},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"countyName":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"elevationFt":{"type":["number","null"],"description":"Reported ground or KB elevation, feet; null when not on file."},"totalDepth":{"type":["number","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."},"tops":{"type":"array","items":{"type":"object","properties":{"formationName":{"type":"string"},"canonicalName":{"type":["string","null"]},"canonicalSlug":{"type":["string","null"]},"formationId":{"type":["number","null"]},"depthFt":{"type":"number"},"subseaFt":{"type":["number","null"],"description":"elevation minus measured depth; null without an elevation"},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["formationName","canonicalName","canonicalSlug","formationId","depthFt","subseaFt","url"]}}},"required":["apiNumber","leaseName","wellNumber","operatorNumber","operatorName","countyName","latitude","longitude","elevationFt","totalDepth","url","operatorUrl","tops"]}}},"required":["wells"]},"CountyRow":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"hasDisposal":{"type":"boolean"},"hasSeismicity":{"type":"boolean"},"countyCode":{"type":["number","null"]},"district":{"type":["number","null"]},"recent90":{"type":"number"},"prior90":{"type":"number"},"permits365":{"type":"number"},"total":{"type":"number"},"operators90":{"type":"number"},"operatorsAll":{"type":"number"},"computedAt":{"type":"string"},"horizontalPct90":{"type":["number","null"]},"avgDepth90":{"type":["number","null"]},"lastIssued":{"type":["string","null"]},"permits":{"type":"number"},"operators":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","hasDisposal","hasSeismicity","countyCode","district","recent90","prior90","permits365","total","operators90","operatorsAll","computedAt","horizontalPct90","avgDepth90","lastIssued","permits","operators","url"]},"Counties":{"type":"object","properties":{"days":{"type":"number"},"computedAt":{"type":["string","null"]},"counties":{"type":"array","items":{"$ref":"#/components/schemas/CountyRow"}}},"required":["days","computedAt","counties"]},"CountyFormation":{"type":"object","properties":{"formationId":{"type":"number"},"formationSlug":{"type":"string"},"formationName":{"type":"string"},"wells":{"type":"number"},"medianDepth":{"type":["number","null"]},"p10Depth":{"type":["number","null"]},"p90Depth":{"type":["number","null"]},"recentWells3y":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["formationId","formationSlug","formationName","wells","medianDepth","p10Depth","p90Depth","recentWells3y","url"]},"CountyDetail":{"type":"object","properties":{"county":{"allOf":[{"$ref":"#/components/schemas/CountyRow"},{"type":"object","properties":{"firstIssued":{"type":["string","null"]},"windowDays":{"type":"number"},"windowCount":{"type":"number"},"priorCount":{"type":"number"},"windowOperators":{"type":"number"},"windowHorizontalPct":{"type":["number","null"]},"windowAvgDepth":{"type":["number","null"]}},"required":["firstIssued","windowDays","windowCount","priorCount","windowOperators","windowHorizontalPct","windowAvgDepth"]}]},"types":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"windowCount":{"type":"number"},"priorCount":{"type":"number"},"total":{"type":"number"}},"required":["code","windowCount","priorCount","total"]}},"topOperators":{"type":"object","properties":{"basis":{"type":"string","enum":["12mo","inventory"]},"rows":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"operatorName":{"type":["string","null"]},"permits":{"type":"number"},"wells":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","permits","wells","url"]}}},"required":["basis","rows"]},"timeline":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"count":{"type":"number"}},"required":["month","count"]}},"newEntrants":{"type":"object","properties":{"total":{"type":"number"},"rows":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"operatorName":{"type":["string","null"]},"firstPermit":{"type":"string"},"permits":{"type":"number"},"activeElsewhere":{"type":"boolean"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","firstPermit","permits","activeElsewhere","url"]}}},"required":["total","rows"]},"disposal":{"type":["object","null"],"properties":{"permits":{"type":"number"},"active":{"type":"number"},"capacityBblPerDay":{"type":"number"},"injectedLast12Bbl":{"type":"number"},"reportedThrough":{"type":["string","null"]}},"required":["permits","active","capacityBblPerDay","injectedLast12Bbl","reportedThrough"]},"seismicity":{"type":["object","null"],"properties":{"count":{"type":"number"},"maxMagnitude":{"type":["number","null"]},"days":{"type":"number"},"note":{"type":"string"}},"required":["count","maxMagnitude","days","note"]},"formations":{"type":"array","items":{"$ref":"#/components/schemas/CountyFormation"}},"briefing":{"type":"array","items":{"type":"string"},"description":"Generated sentences built only from counted facts."}},"required":["county","types","topOperators","timeline","newEntrants","disposal","seismicity","formations","briefing"]},"CountyOperators":{"type":"object","properties":{"countyName":{"type":"string"},"days":{"anyOf":[{"type":"number"},{"type":"string","enum":["all"]}]},"total":{"type":"number"},"operators":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"operatorName":{"type":["string","null"]},"permits":{"type":"number"},"permitsAll":{"type":"number"},"horizontal":{"type":"number"},"wells":{"type":"number"},"firstPermit":{"type":["string","null"]},"lastPermit":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","permits","permitsAll","horizontal","wells","firstPermit","lastPermit","url"]}}},"required":["countyName","days","total","operators"]},"OperatorRow":{"type":"object","properties":{"operatorNumber":{"type":"number"},"name":{"type":"string"},"permits7":{"type":"number"},"permits30":{"type":"number"},"prior30":{"type":"number"},"permits90":{"type":"number"},"prior90":{"type":"number"},"permits180":{"type":"number"},"prior180":{"type":"number"},"permits365":{"type":"number"},"prior365":{"type":"number"},"counties90":{"type":"number"},"counties365":{"type":"number"},"hzPct365":{"type":["number","null"]},"avgDepth365":{"type":["number","null"]},"totalPermits":{"type":"number"},"firstIssued":{"type":["string","null"]},"lastIssued":{"type":["string","null"]},"topCounty365":{"type":["string","null"]},"topCountySlug365":{"type":["string","null"]},"wellsTotal":{"type":"number"},"wellsProducing":{"type":"number"},"wellsShutIn":{"type":"number"},"wellsInjection":{"type":"number"},"uicPermits":{"type":"number"},"uicActive":{"type":"number"},"uicCapacityBblD":{"type":"number"},"injectedLast12Bbl":{"type":"number"},"injectionAnchor":{"type":["string","null"]},"oilLast12Bbl":{"type":"number"},"gasLast12Mcf":{"type":"number"},"oilPrior12Bbl":{"type":"number"},"cumOilBbl":{"type":"number"},"cumGasMcf":{"type":"number"},"productionAnchor":{"type":["string","null"]},"computedAt":{"type":"string"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","name","permits7","permits30","prior30","permits90","prior90","permits180","prior180","permits365","prior365","counties90","counties365","hzPct365","avgDepth365","totalPermits","firstIssued","lastIssued","topCounty365","topCountySlug365","wellsTotal","wellsProducing","wellsShutIn","wellsInjection","uicPermits","uicActive","uicCapacityBblD","injectedLast12Bbl","injectionAnchor","oilLast12Bbl","gasLast12Mcf","oilPrior12Bbl","cumOilBbl","cumGasMcf","productionAnchor","computedAt","url"]},"Operators":{"anyOf":[{"type":"object","properties":{"q":{"type":"string"},"operators":{"type":"array","items":{"$ref":"#/components/schemas/OperatorRow"}}},"required":["q","operators"],"description":"Name search (view=active with q)."},{"type":"object","properties":{"days":{"type":"number"},"total":{"type":"number"},"computedAt":{"type":["string","null"]},"operators":{"type":"array","items":{"$ref":"#/components/schemas/OperatorRow"}}},"required":["days","total","computedAt","operators"],"description":"Active ranking."},{"type":"object","properties":{"view":{"type":"string","enum":["all"]},"q":{"type":"string"},"sort":{"type":"string"},"total":{"type":"number"},"computedAt":{"type":["string","null"]},"operators":{"type":"array","items":{"$ref":"#/components/schemas/OperatorRow"}}},"required":["view","sort","total","computedAt","operators"],"description":"The whole directory."}]},"OperatorScorecard":{"type":["object","null"],"properties":{"maturePermits":{"type":"number"},"spudded":{"type":"number"},"spudRatePct":{"type":["number","null"]},"cancelled":{"type":"number"},"cancelRatePct":{"type":["number","null"]},"expiredUndrilled":{"type":"number"},"medianSpudDays":{"type":["number","null"]},"p25SpudDays":{"type":["number","null"]},"p75SpudDays":{"type":["number","null"]},"spuds180":{"type":"number"},"spudsPrior180":{"type":"number"},"avgPermitsPerYear":{"type":["number","null"]},"activeYears":{"type":"number"}},"required":["maturePermits","spudded","spudRatePct","cancelled","cancelRatePct","expiredUndrilled","medianSpudDays","p25SpudDays","p75SpudDays","spuds180","spudsPrior180","avgPermitsPerYear","activeYears"]},"Operator":{"type":"object","properties":{"scorecard":{"$ref":"#/components/schemas/OperatorScorecard"},"operator":{"$ref":"#/components/schemas/OperatorRow"},"p5":{"type":["object","null"],"properties":{"address":{"type":["string","null"]},"city":{"type":["string","null"]},"stateCode":{"type":["string","null"]},"zip":{"type":["string","null"]},"phone":{"type":["string","null"]},"p5Status":{"type":["string","null"]},"p5FiledDate":{"type":["string","null"]},"activities":{"type":"array","items":{"type":"string"}},"officers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"title":{"type":["string","null"]}},"required":["name","title"]}}},"required":["address","city","stateCode","zip","phone","p5Status","p5FiledDate","activities","officers"]},"leasesTotal":{"type":"number","description":"Leases the operator reports production for."},"wells":{"type":"object","properties":{"total":{"type":"number"},"onSchedule":{"type":"number"},"producing":{"type":"number"},"shutIn":{"type":"number"},"tempAbandoned":{"type":"number"},"injection":{"type":"number"},"plugged":{"type":"number"},"acquired":{"type":"number"},"divested":{"type":"number"},"selfPermitted":{"type":"number"}},"required":["total","onSchedule","producing","shutIn","tempAbandoned","injection","plugged","acquired","divested","selfPermitted"]},"types":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"windowCount":{"type":"number"},"priorCount":{"type":"number"},"total":{"type":"number"}},"required":["code","windowCount","priorCount","total"]}},"fields":{"type":"array","items":{"type":"object","properties":{"fieldName":{"type":"string"},"fieldNumber":{"type":["string","null"]},"wells":{"type":"number"},"producing":{"type":"number"}},"required":["fieldName","fieldNumber","wells","producing"]}},"waterCounties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"countySlug":{"type":"string"},"permits":{"type":"number"},"active":{"type":"number"},"capacityBblD":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","countySlug","permits","active","capacityBblD","url"]}},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"countySlug":{"type":"string"},"permits365":{"type":"number"},"permitsAll":{"type":"number"},"wells":{"type":"number"},"firstIssued":{"type":["string","null"]},"lastIssued":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","countySlug","permits365","permitsAll","wells","firstIssued","lastIssued","url"]},"description":"Counties by the operator's own permits. Empty when every well was acquired; see wellCounties."},"wellCounties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"countySlug":{"type":"string"},"wells":{"type":"number"},"producing":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","countySlug","wells","producing","url"]},"description":"Counties of its wells of record in the RRC wellbore file, most wells first."},"formations":{"type":"array","items":{"type":"object","properties":{"formationId":{"type":"number"},"formationSlug":{"type":"string"},"formationName":{"type":"string"},"wells":{"type":"number"},"recentWells3y":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["formationId","formationSlug","formationName","wells","recentWells3y","url"]}},"timeline":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"count":{"type":"number"}},"required":["month","count"]}},"production":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"oilBbl":{"type":"number"},"gasMcf":{"type":"number"}},"required":["month","oilBbl","gasMcf"]}},"briefing":{"type":"array","items":{"type":"string"}},"recentPermits":{"type":"array","items":{"$ref":"#/components/schemas/Permit"}}},"required":["scorecard","operator","p5","leasesTotal","wells","types","fields","waterCounties","counties","wellCounties","formations","timeline","production","briefing","recentPermits"]},"OperatorPermits":{"type":"object","properties":{"operatorNumber":{"type":"number"},"query":{"type":"object","additionalProperties":{}},"total":{"type":"number"},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"count":{"type":"number"}},"required":["countyName","count"]}},"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":"number"},"apiNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"applicationType":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"isHorizontal":{"type":["boolean","null"]},"dateIssued":{"type":["string","null"]},"dateSpud":{"type":["string","null"]},"wellStatus":{"type":["string","null"]},"firstSeenAt":{"type":["string","null"]},"currentOperatorNumber":{"type":["number","null"]},"currentOperatorName":{"type":["string","null"]},"relationship":{"type":"string","enum":["filed","acquired"]},"permitOperatorNumber":{"type":["number","null"]},"permitOperatorName":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"wellUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."},"currentOperatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","permitNumber","apiNumber","countyName","leaseName","wellNumber","applicationType","totalDepth","isHorizontal","dateIssued","dateSpud","wellStatus","firstSeenAt","currentOperatorNumber","currentOperatorName","relationship","permitOperatorNumber","permitOperatorName","url","wellUrl","currentOperatorUrl"]}}},"required":["operatorNumber","query","total","counties","rows"]},"OperatorWells":{"type":"object","properties":{"operatorNumber":{"type":"number"},"query":{"type":"object","additionalProperties":{}},"total":{"type":"number"},"types":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"count":{"type":"number"}},"required":["type","count"]}},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"count":{"type":"number"}},"required":["countyName","count"]}},"rows":{"type":"array","items":{"type":"object","properties":{"apiNumber":{"type":"string"},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"fieldName":{"type":["string","null"]},"wellTypeName":{"type":["string","null"]},"onSchedule":{"type":["string","null"]},"completionDate":{"type":["string","null"]},"shutInDate":{"type":["string","null"]},"plugDate":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"permitOperatorNumber":{"type":["number","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["apiNumber","leaseName","wellNumber","countyName","fieldName","wellTypeName","onSchedule","completionDate","shutInDate","plugDate","totalDepth","permitOperatorNumber","url"]}}},"required":["operatorNumber","query","total","types","counties","rows"]},"OperatorCounty":{"type":"object","properties":{"operatorNumber":{"type":"number"},"operatorName":{"type":"string"},"countyName":{"type":"string"},"countySlug":{"type":"string"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"operatorUrl":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"countyUrl":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"permits365":{"type":"number"},"permitsPrior365":{"type":"number"},"permitsAll":{"type":"number"},"firstIssued":{"type":["string","null"]},"lastIssued":{"type":["string","null"]},"horizontalPct365":{"type":["number","null"]},"avgDepth365":{"type":["number","null"]},"wells":{"type":"number"},"wellsProducing":{"type":"number"},"wellsShutIn":{"type":"number"},"wellsInjection":{"type":"number"},"timeline":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"count":{"type":"number"}},"required":["month","count"]}},"types":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"count365":{"type":"number"},"total":{"type":"number"}},"required":["code","count365","total"]}},"formations":{"type":"array","items":{"type":"object","properties":{"formationSlug":{"type":"string"},"formationName":{"type":"string"},"wells":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["formationSlug","formationName","wells","url"]}},"leases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"leaseName":{"type":["string","null"]},"wellCount":{"type":"number"},"lastProduction":{"type":["string","null"]},"totalOilBbl":{"type":"number"},"totalGasMcf":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","leaseName","wellCount","lastProduction","totalOilBbl","totalGasMcf","url"]}},"recentPermits":{"type":"array","items":{"type":"object","properties":{"permitNumber":{"type":["number","null"]},"apiNumber":{"type":["string","null"]},"dateIssued":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"applicationType":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"isHorizontal":{"type":["boolean","null"]},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["permitNumber","apiNumber","dateIssued","leaseName","wellNumber","countyName","applicationType","totalDepth","isHorizontal","url"]}},"briefing":{"type":"array","items":{"type":"string"}}},"required":["operatorNumber","operatorName","countyName","countySlug","url","operatorUrl","countyUrl","permits365","permitsPrior365","permitsAll","firstIssued","lastIssued","horizontalPct365","avgDepth365","wells","wellsProducing","wellsShutIn","wellsInjection","timeline","types","formations","leases","recentPermits","briefing"]},"Fields":{"type":"object","properties":{"query":{"type":"object","additionalProperties":{}},"total":{"type":"number"},"rows":{"type":"array","items":{"type":"object","properties":{"fieldNo":{"type":"number"},"fieldName":{"type":"string"},"district":{"type":["number","null"]},"leaseCount":{"type":"number"},"operatorCount":{"type":"number"},"totalOilBbl":{"type":"number"},"totalGasMcf":{"type":"number","description":"Gas-well gas plus casinghead."},"lastProduction":{"type":["string","null"],"description":"YYYY-MM of the last lease report."},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["fieldNo","fieldName","district","leaseCount","operatorCount","totalOilBbl","totalGasMcf","lastProduction","url"]}}},"required":["query","total","rows"]},"Field":{"type":"object","properties":{"fieldNo":{"type":"number"},"fieldName":{"type":"string"},"district":{"type":["number","null"]},"leaseCount":{"type":"number"},"operatorCount":{"type":"number"},"totalOilBbl":{"type":"number"},"totalGasMcf":{"type":"number","description":"Gas-well gas plus casinghead."},"lastProduction":{"type":["string","null"],"description":"YYYY-MM of the last lease report."},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"leases":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","leases","url"]}},"operators":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"operatorName":{"type":["string","null"]},"leases":{"type":"number"},"totalOilBbl":{"type":"number"},"totalGasMcf":{"type":"number"},"lastProduction":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","leases","totalOilBbl","totalGasMcf","lastProduction","url"]}},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"oilBbl":{"type":"number"},"gasMcf":{"type":"number"},"leasesReporting":{"type":"number"}},"required":["month","oilBbl","gasMcf","leasesReporting"]},"description":"Ten years, cut at the statewide reported-through month."},"reportedThrough":{"type":["string","null"]},"last12":{"type":"object","properties":{"oilBbl":{"type":"number"},"gasMcf":{"type":"number"},"priorOilBbl":{"type":"number"},"priorGasMcf":{"type":"number"},"leasesReporting":{"type":"number"}},"required":["oilBbl","gasMcf","priorOilBbl","priorGasMcf","leasesReporting"]},"leaseTypes":{"type":"object","properties":{"oil":{"type":"number"},"gas":{"type":"number"}},"required":["oil","gas"]},"briefing":{"type":"array","items":{"type":"string"}},"leasesUrl":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["fieldNo","fieldName","district","leaseCount","operatorCount","totalOilBbl","totalGasMcf","lastProduction","url","counties","operators","monthly","reportedThrough","last12","leaseTypes","briefing","leasesUrl"]},"MapPermits":{"type":"object","properties":{"query":{"type":"object","additionalProperties":{}},"cols":{"type":"array","items":{"type":"string"},"example":["permitNumber","lon","lat","horizontal","apiNumber"]},"total":{"type":"number"},"rows":{"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":["string","null"]}]},"description":"One array per permit, in the order of `cols`."},"located":{"type":"number","description":"Rows with a location; `total` counts every permit the filters match."}},"required":["query","cols","total","rows","located"]},"MapDisposal":{"type":"object","properties":{"query":{"type":"object","additionalProperties":{}},"cols":{"type":"array","items":{"type":"string"},"example":["uicNumber","apiNumber","lon","lat"]},"total":{"type":"number"},"rows":{"type":"array","items":{"type":"array","prefixItems":[{"type":"string"},{"type":["string","null"]},{"type":"number"},{"type":"number"}]},"description":"One array per well, in the order of `cols`."}},"required":["query","cols","total","rows"]},"MapEarthquakes":{"type":"object","properties":{"query":{"type":"object","additionalProperties":{}},"cols":{"type":"array","items":{"type":"string"},"example":["id","lon","lat","magnitude","date"]},"total":{"type":"number"},"rows":{"type":"array","items":{"type":"array","prefixItems":[{"type":"string"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"string"}]},"description":"One array per event, in the order of `cols`."}},"required":["query","cols","total","rows"]},"Basins":{"type":"object","properties":{"basins":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"shortName":{"type":"string"},"districts":{"type":"array","items":{"type":"number"},"description":"RRC districts as stored on permits."},"blurb":{"type":"string"},"counties":{"type":"number"},"totalPermits":{"type":"number"},"permits90":{"type":"number"},"prior90":{"type":"number"},"permits365":{"type":"number"},"prior365":{"type":"number"},"operators90":{"type":"number"},"hzPct90":{"type":["number","null"]},"avgDepth90":{"type":["number","null"]},"lastIssued":{"type":["string","null"]},"firstIssued":{"type":["string","null"]},"uicActive":{"type":"number"},"injectedLast12Bbl":{"type":"number"},"quakesM2Last2y":{"type":"number"},"topCounties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"permits90":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","permits90","url"]}},"computedAt":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["slug","name","shortName","districts","blurb","counties","totalPermits","permits90","prior90","permits365","prior365","operators90","hzPct90","avgDepth90","lastIssued","firstIssued","uicActive","injectedLast12Bbl","quakesM2Last2y","topCounties","computedAt","url"]}}},"required":["basins"]},"Basin":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"shortName":{"type":"string"},"districts":{"type":"array","items":{"type":"number"},"description":"RRC districts as stored on permits."},"blurb":{"type":"string"},"counties":{"type":"number"},"totalPermits":{"type":"number"},"permits90":{"type":"number"},"prior90":{"type":"number"},"permits365":{"type":"number"},"prior365":{"type":"number"},"operators90":{"type":"number"},"hzPct90":{"type":["number","null"]},"avgDepth90":{"type":["number","null"]},"lastIssued":{"type":["string","null"]},"firstIssued":{"type":["string","null"]},"uicActive":{"type":"number"},"injectedLast12Bbl":{"type":"number"},"quakesM2Last2y":{"type":"number"},"topCounties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"permits90":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","permits90","url"]}},"computedAt":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"countiesAll":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"district":{"type":"number"},"permits90":{"type":"number"},"prior90":{"type":"number"},"permits365":{"type":"number"},"totalPermits":{"type":"number"},"operators90":{"type":"number"},"hzPct90":{"type":["number","null"]},"avgDepth90":{"type":["number","null"]},"lastIssued":{"type":["string","null"]},"uicActive":{"type":"number"},"quakesM2Last2y":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","district","permits90","prior90","permits365","totalPermits","operators90","hzPct90","avgDepth90","lastIssued","uicActive","quakesM2Last2y","url"]}},"operators":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"operatorName":{"type":["string","null"]},"permits365":{"type":"number"},"prior365":{"type":"number"},"permitsAll":{"type":"number"},"counties365":{"type":"number"},"hzPct365":{"type":["number","null"]},"lastIssued":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","permits365","prior365","permitsAll","counties365","hzPct365","lastIssued","url"]}},"timeline":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"count":{"type":"number"}},"required":["month","count"]},"description":"Permits issued per month, five years."},"recentPermits":{"type":"array","items":{"$ref":"#/components/schemas/Permit"}},"briefing":{"type":"array","items":{"type":"string"}}},"required":["slug","name","shortName","districts","blurb","counties","totalPermits","permits90","prior90","permits365","prior365","operators90","hzPct90","avgDepth90","lastIssued","firstIssued","uicActive","injectedLast12Bbl","quakesM2Last2y","topCounties","computedAt","url","countiesAll","operators","timeline","recentPermits","briefing"]},"FormationSummary":{"type":"object","properties":{"formationId":{"type":"number"},"slug":{"type":"string"},"name":{"type":"string"},"wells":{"type":"number"},"counties":{"type":"number"},"medianDepth":{"type":["number","null"]},"p10Depth":{"type":["number","null"]},"p90Depth":{"type":["number","null"]},"recentWells3y":{"type":"number"},"computedAt":{"type":"string"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["formationId","slug","name","wells","counties","medianDepth","p10Depth","p90Depth","recentWells3y","computedAt","url"]},"Formations":{"type":"object","properties":{"computedAt":{"type":["string","null"]},"formations":{"type":"array","items":{"$ref":"#/components/schemas/FormationSummary"}}},"required":["computedAt","formations"]},"Formation":{"type":"object","properties":{"formation":{"$ref":"#/components/schemas/FormationSummary"},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"countySlug":{"type":"string"},"wells":{"type":"number"},"medianDepth":{"type":["number","null"]},"p10Depth":{"type":["number","null"]},"p90Depth":{"type":["number","null"]},"recentWells3y":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","countySlug","wells","medianDepth","p10Depth","p90Depth","recentWells3y","url"]}},"operators":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"operatorName":{"type":["string","null"]},"wells":{"type":"number"},"recentWells3y":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","wells","recentWells3y","url"]}},"recentWells":{"type":"array","items":{"type":"object","properties":{"apiNumber":{"type":"string"},"leaseName":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"countyName":{"type":["string","null"]},"lastIssued":{"type":["string","null"]},"depthFt":{"type":["number","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["apiNumber","leaseName","operatorNumber","operatorName","countyName","lastIssued","depthFt","url"]}}},"required":["formation","counties","operators","recentWells"]},"LeaseRow":{"type":"object","properties":{"id":{"type":"string","description":"type-district-lease","example":"o-10-64741"},"oilGasCode":{"type":"string"},"districtNo":{"type":"number"},"leaseNo":{"type":"number"},"leaseName":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"countyName":{"type":["string","null"],"description":"Headline county: where most of the lease's completed wells are. Lease reports leave county blank."},"fieldName":{"type":["string","null"]},"fieldNo":{"type":["number","null"]},"districtName":{"type":["string","null"]},"totalOilBbl":{"type":"number"},"totalGasMcf":{"type":"number"},"totalCsgdMcf":{"type":"number"},"firstProduction":{"type":["string","null"]},"lastProduction":{"type":["string","null"]},"wellCount":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","oilGasCode","districtNo","leaseNo","leaseName","operatorNumber","operatorName","countyName","fieldName","fieldNo","districtName","totalOilBbl","totalGasMcf","totalCsgdMcf","firstProduction","lastProduction","wellCount","url","operatorUrl"]},"Leases":{"type":"object","properties":{"query":{"type":"object","additionalProperties":{}},"total":{"type":"number"},"rows":{"type":"array","items":{"$ref":"#/components/schemas/LeaseRow"}}},"required":["query","total","rows"]},"LeaseWellRow":{"type":"object","properties":{"apiNumber":{"type":["string","null"]},"wellNo":{"type":["string","null"]},"completionDate":{"type":["string","null"]},"statusDesc":{"type":["string","null"]},"permitOperatorName":{"type":["string","null"]},"currentOperatorNumber":{"type":["number","null"]},"currentOperatorName":{"type":["string","null"]},"permitCount":{"type":"number"},"maxDepth":{"type":["number","null"]},"lastIssued":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["apiNumber","wellNo","completionDate","statusDesc","permitOperatorName","currentOperatorNumber","currentOperatorName","permitCount","maxDepth","lastIssued","url"]},"Lease":{"type":"object","properties":{"lease":{"$ref":"#/components/schemas/LeaseRow"},"fields":{"type":"array","items":{"type":"object","properties":{"fieldName":{"type":"string"},"fieldNo":{"type":["number","null"]}},"required":["fieldName","fieldNo"]}},"history":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"oilBbl":{"type":"number"},"gasMcf":{"type":"number"},"condBbl":{"type":"number"},"csgdMcf":{"type":"number"},"oilAllowBbl":{"type":"number"},"gasAllowMcf":{"type":"number"},"operatorNumber":{"type":["number","null"]}},"required":["month","oilBbl","gasMcf","condBbl","csgdMcf","oilAllowBbl","gasAllowMcf","operatorNumber"]}},"reportedThrough":{"type":["string","null"]},"lastReported":{"type":["string","null"]},"status":{"type":"string","enum":["reporting","idle","none"]},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"wells":{"type":"number"}},"required":["countyName","slug","wells"]},"description":"Every county the lease's completed wells are in, most wells first."},"operatorRuns":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"firstMonth":{"type":"string","description":"YYYY-MM","example":"2026-04"},"lastMonth":{"type":"string","description":"YYYY-MM","example":"2026-04"},"months":{"type":"number"},"operatorUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","firstMonth","lastMonth","months","operatorUrl"]}},"wells":{"type":"object","properties":{"total":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"byStatus":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string"},"count":{"type":"number"}},"required":["status","count"]}},"byOperator":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"count":{"type":"number"},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","operatorName","count","url"]}},"newest":{"type":"array","items":{"$ref":"#/components/schemas/LeaseWellRow"}}},"required":["total","url","byStatus","byOperator","newest"]},"peak":{"type":["object","null"],"properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"oilBbl":{"type":"number"}},"required":["month","oilBbl"]},"last12":{"type":"object","properties":{"oilBbl":{"type":"number"},"gasMcf":{"type":"number"},"priorOilBbl":{"type":"number"}},"required":["oilBbl","gasMcf","priorOilBbl"]},"decline":{"type":["object","null"],"properties":{"type":{"type":"string","enum":["exponential","hyperbolic"]},"qi":{"type":"number"},"di":{"type":"number","description":"Nominal initial decline, annual fraction."},"b":{"type":"number"},"rSquared":{"type":"number"},"monthsFit":{"type":"number"},"peakMonth":{"type":"string","description":"YYYY-MM","example":"2026-04"},"remaining":{"type":"number"},"forecast":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"value":{"type":"number"}},"required":["month","value"]}},"curve":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"value":{"type":"number"}},"required":["month","value"]}},"effectiveDi":{"type":"number","description":"Effective first-year decline from the peak, fraction."},"product":{"type":"string","enum":["oil","gas"]}},"required":["type","qi","di","b","rSquared","monthsFit","peakMonth","remaining","forecast","curve","effectiveDi","product"],"description":"A model fitted to the last ten years of reports, or null when the reports do not follow one curve (R² < 0.7). Never a report."},"briefing":{"type":"array","items":{"type":"string"}}},"required":["lease","fields","history","reportedThrough","lastReported","status","counties","operatorRuns","wells","peak","last12","decline","briefing"]},"LeaseWells":{"type":"object","properties":{"leaseId":{"type":"string"},"query":{"type":"object","additionalProperties":{}},"total":{"type":"number"},"statuses":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string"},"count":{"type":"number"}},"required":["status","count"]}},"operators":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"operatorName":{"type":["string","null"]},"count":{"type":"number"}},"required":["operatorNumber","operatorName","count"]}},"rows":{"type":"array","items":{"$ref":"#/components/schemas/LeaseWellRow"}}},"required":["leaseId","query","total","statuses","operators","rows"]},"Water":{"type":"object","properties":{"h10":{"type":"object","properties":{"reportedThrough":{"type":["string","null"]},"injectedLast12Bbl":{"type":"number"},"injectedPrior12Bbl":{"type":"number"},"yoyPct":{"type":["number","null"]},"reportingWellsLastMonth":{"type":"number"},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"count":{"type":"number"}},"required":["month","count"]}}},"required":["reportedThrough","injectedLast12Bbl","injectedPrior12Bbl","yoyPct","reportingWellsLastMonth","monthly"]},"uic":{"type":"object","properties":{"permits":{"type":"number"},"active":{"type":"number"},"capacityBblPerDay":{"type":"number"}},"required":["permits","active","capacityBblPerDay"]},"disposalPermits":{"type":"object","properties":{"last365":{"type":"number"},"prior365":{"type":"number"},"yoyPct":{"type":["number","null"]},"recent":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":["number","null"]},"apiNumber":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"countyName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"dateIssued":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."},"wellUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","permitNumber","apiNumber","operatorNumber","operatorName","countyName","leaseName","wellNumber","dateIssued","url","wellUrl"]}}},"required":["last365","prior365","yoyPct","recent"]},"texnet":{"type":["object","null"],"properties":{"settledMonth":{"type":"string","description":"YYYY-MM","example":"2026-04"},"reportedThrough":{"type":["string","null"]},"volMonthBbl":{"type":"number"},"bblPerDay":{"type":"number"},"wells":{"type":"number"},"operators":{"type":"number"},"sameWellYoYPct":{"type":["number","null"]},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"bblPerDay":{"type":"number"},"wells":{"type":"number"},"operators":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","bblPerDay","wells","operators","url"]}}},"required":["settledMonth","reportedThrough","volMonthBbl","bblPerDay","wells","operators","sameWellYoYPct","counties"]},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"uicPermits":{"type":"number"},"uicActive":{"type":"number"},"capacityBblPerDay":{"type":"number"},"injectedLast12Bbl":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","uicPermits","uicActive","capacityBblPerDay","injectedLast12Bbl","url"]}},"operators":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"name":{"type":"string"},"injectedLast12Bbl":{"type":"number"},"injectedPrior12Bbl":{"type":"number"},"yoyPct":{"type":["number","null"]},"uicActive":{"type":"number"},"capacityBblPerDay":{"type":"number"},"counties":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","name","injectedLast12Bbl","injectedPrior12Bbl","yoyPct","uicActive","capacityBblPerDay","counties","url"]}},"computedAt":{"type":["string","null"]},"briefing":{"type":"array","items":{"type":"string"}},"split":{"type":"object","properties":{"disposal":{"type":"number"},"disposalActive":{"type":"number"},"eor":{"type":"number"},"eorActive":{"type":"number"},"other":{"type":"number"},"otherActive":{"type":"number"}},"required":["disposal","disposalActive","eor","eorActive","other","otherActive"]},"disposalPermitsByYear":{"type":"array","items":{"type":"object","properties":{"year":{"type":"number"},"count":{"type":"number"}},"required":["year","count"]}},"zoneDepths":{"type":"array","items":{"type":"object","properties":{"fromFt":{"type":"number"},"count":{"type":"number"},"capacityBblPerDay":{"type":"number"}},"required":["fromFt","count","capacityBblPerDay"]}}},"required":["h10","uic","disposalPermits","texnet","counties","operators","computedAt","briefing","split","disposalPermitsByYear","zoneDepths"]},"WaterCounty":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"countyUrl":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"uic":{"type":"object","properties":{"permits":{"type":"number"},"active":{"type":"number"},"capacityBblPerDay":{"type":"number"},"disposalActive":{"type":"number"}},"required":["permits","active","capacityBblPerDay","disposalActive"]},"h10":{"type":"object","properties":{"reportedThrough":{"type":["string","null"]},"injectedLast12Bbl":{"type":"number"},"injectedPrior12Bbl":{"type":"number"},"yoyPct":{"type":["number","null"]},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"count":{"type":"number"}},"required":["month","count"]}},"utilizationPct":{"type":["number","null"]}},"required":["reportedThrough","injectedLast12Bbl","injectedPrior12Bbl","yoyPct","monthly","utilizationPct"]},"texnet":{"type":["object","null"],"properties":{"settledMonth":{"type":"string","description":"YYYY-MM","example":"2026-04"},"wells":{"type":"number"},"operators":{"type":"number"},"bblPerDay":{"type":"number"},"sameWellYoYPct":{"type":["number","null"]},"wells_top":{"type":"array","items":{"type":"object","properties":{"uicNumber":{"type":"string"},"apiNumber":{"type":["string","null"]},"operatorName":{"type":["string","null"]},"bblPerDay":{"type":"number"}},"required":["uicNumber","apiNumber","operatorName","bblPerDay"]}}},"required":["settledMonth","wells","operators","bblPerDay","sameWellYoYPct","wells_top"]},"operators":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"name":{"type":"string"},"activeWells":{"type":"number"},"capacityBblPerDay":{"type":"number"},"injectedLast12Bbl":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["operatorNumber","name","activeWells","capacityBblPerDay","injectedLast12Bbl","url"]}},"wells":{"type":"array","items":{"type":"object","properties":{"uicNumber":{"type":"string"},"apiNumber":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNo":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"purpose":{"type":"string","enum":["disposal","eor","other"]},"capacityBblPerDay":{"type":["number","null"]},"topZoneFt":{"type":["number","null"]},"botZoneFt":{"type":["number","null"]},"permittedOn":{"type":["string","null"]},"injectedLast12Bbl":{"type":["number","null"]},"status":{"type":"string","enum":["active","cancelled","plugged","inactive"]},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["uicNumber","apiNumber","leaseName","wellNo","operatorNumber","operatorName","purpose","capacityBblPerDay","topZoneFt","botZoneFt","permittedOn","injectedLast12Bbl","status","url"]}},"wellsTotal":{"type":"number"},"wellsPage":{"type":"number"},"wellsPageSize":{"type":"number"},"seismicity":{"type":["object","null"],"properties":{"m2Last2y":{"type":"number"},"maxMagnitude":{"type":["number","null"]}},"required":["m2Last2y","maxMagnitude"]},"recentPermits":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":["number","null"]},"apiNumber":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"countyName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"dateIssued":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."},"wellUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","permitNumber","apiNumber","operatorNumber","operatorName","countyName","leaseName","wellNumber","dateIssued","url","wellUrl"]}},"briefing":{"type":"array","items":{"type":"string"}}},"required":["countyName","slug","countyUrl","uic","h10","texnet","operators","wells","wellsTotal","wellsPage","wellsPageSize","seismicity","recentPermits","briefing"]},"QuakeEventRow":{"type":"object","properties":{"id":{"type":"string"},"time":{"type":"string","description":"ISO 8601, UTC."},"magnitude":{"type":"number"},"place":{"type":["string","null"]},"depthKm":{"type":["number","null"]},"latitude":{"type":"number"},"longitude":{"type":"number"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","time","magnitude","place","depthKm","latitude","longitude","url"]},"Earthquakes":{"type":"object","properties":{"bins":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"count":{"type":"number"}},"required":["from","count"]}},"largest":{"type":"array","items":{"$ref":"#/components/schemas/QuakeEventRow"}},"m2Last365":{"type":"number"},"m2Prior365":{"type":"number"},"m3Last365":{"type":"number"},"m3Prior365":{"type":"number"},"m5AllTime":{"type":"number"},"maxMagnitude":{"type":["number","null"]},"catalogFrom":{"type":["string","null"]},"catalogThrough":{"type":["string","null"]},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"count":{"type":"number"},"m2":{"type":"number"},"m3":{"type":"number"},"maxMagnitude":{"type":["number","null"]}},"required":["month","count","m2","m3","maxMagnitude"]}},"yearly":{"type":"array","items":{"type":"object","properties":{"year":{"type":"number"},"m2":{"type":"number"},"m3":{"type":"number"},"maxMagnitude":{"type":["number","null"]}},"required":["year","m2","m3","maxMagnitude"]}},"counties":{"type":"array","items":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"m2Last2y":{"type":"number"},"maxMagnitude":{"type":["number","null"]},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","m2Last2y","maxMagnitude","url"]}},"recent":{"type":"array","items":{"$ref":"#/components/schemas/QuakeEventRow"}},"briefing":{"type":"array","items":{"type":"string"}}},"required":["bins","largest","m2Last365","m2Prior365","m3Last365","m3Prior365","m5AllTime","maxMagnitude","catalogFrom","catalogThrough","monthly","yearly","counties","recent","briefing"]},"EarthquakeArea":{"type":"object","properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"countyUrl":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."},"waterUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."},"box":{"type":"object","properties":{"s":{"type":"number"},"n":{"type":"number"},"w":{"type":"number"},"e":{"type":"number"}},"required":["s","n","w","e"],"description":"The county's located-permit bounding box ±0.1°; events are counted inside it because the catalog carries no county."},"locatedPermits":{"type":"number"},"m2Last365":{"type":"number"},"m2Prior365":{"type":"number"},"m3Last365":{"type":"number"},"m2Last2y":{"type":"number"},"maxMagnitude":{"type":["number","null"]},"maxEvent":{"allOf":[{"$ref":"#/components/schemas/QuakeEventRow"},{"type":["object","null"]}]},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM","example":"2026-04"},"count":{"type":"number"},"m2":{"type":"number"},"m3":{"type":"number"},"maxMagnitude":{"type":["number","null"]}},"required":["month","count","m2","m3","maxMagnitude"]}},"yearly":{"type":"array","items":{"type":"object","properties":{"year":{"type":"number"},"m2":{"type":"number"},"m3":{"type":"number"},"maxMagnitude":{"type":["number","null"]}},"required":["year","m2","m3","maxMagnitude"]}},"bins":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"count":{"type":"number"}},"required":["from","count"]}},"recent":{"type":"array","items":{"$ref":"#/components/schemas/QuakeEventRow"}},"disposal":{"type":["object","null"],"properties":{"active":{"type":"number"},"capacityBblPerDay":{"type":"number"},"injectedLast12Bbl":{"type":"number"},"reportedThrough":{"type":["string","null"]}},"required":["active","capacityBblPerDay","injectedLast12Bbl","reportedThrough"]},"texnet":{"type":["object","null"],"properties":{"settledMonth":{"type":"string","description":"YYYY-MM","example":"2026-04"},"wells":{"type":"number"},"bblPerDay":{"type":"number"}},"required":["settledMonth","wells","bblPerDay"]},"briefing":{"type":"array","items":{"type":"string"}}},"required":["countyName","slug","countyUrl","waterUrl","box","locatedPermits","m2Last365","m2Prior365","m3Last365","m2Last2y","maxMagnitude","maxEvent","monthly","yearly","bins","recent","disposal","texnet","briefing"]},"EarthquakeEvent":{"type":"object","properties":{"event":{"type":"object","properties":{"id":{"type":"string"},"time":{"type":"string"},"magnitude":{"type":"number"},"place":{"type":["string","null"]},"depthKm":{"type":["number","null"]},"latitude":{"type":"number"},"longitude":{"type":"number"},"magType":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["id","time","magnitude","place","depthKm","latitude","longitude","magType","status"]},"area":{"type":["object","null"],"properties":{"countyName":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["countyName","slug","url"]},"nearby":{"type":"object","properties":{"radiusKm":{"type":"number"},"last30":{"type":"number"},"last365":{"type":"number"},"allTime":{"type":"number"},"largest":{"allOf":[{"$ref":"#/components/schemas/QuakeEventRow"},{"type":["object","null"]}]},"recent":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/QuakeEventRow"},{"type":"object","properties":{"distanceKm":{"type":"number"}},"required":["distanceKm"]}]}}},"required":["radiusKm","last30","last365","allTime","largest","recent"]},"disposalWells":{"type":"array","items":{"type":"object","properties":{"uicNumber":{"type":"string"},"apiNumber":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNo":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"capacityBblPerDay":{"type":["number","null"]},"topZoneFt":{"type":["number","null"]},"botZoneFt":{"type":["number","null"]},"distanceKm":{"type":"number"},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["uicNumber","apiNumber","leaseName","wellNo","operatorNumber","operatorName","capacityBblPerDay","topZoneFt","botZoneFt","distanceKm","url"]},"description":"Active injection wells within the radius. Proximity, not attribution."},"texnet":{"type":["object","null"],"properties":{"settledMonth":{"type":"string","description":"YYYY-MM","example":"2026-04"},"wells":{"type":"number"},"bblPerDay":{"type":"number"}},"required":["settledMonth","wells","bblPerDay"]},"permitsNearby":{"type":"number"},"briefing":{"type":"array","items":{"type":"string"}}},"required":["event","area","nearby","disposalWells","texnet","permitsNearby","briefing"]},"Me":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":["string","null"]},"name":{"type":["string","null"]},"company":{"type":["string","null"]},"avatarUrl":{"type":["string","null"]}},"required":["id","email","name","company","avatarUrl"]}},"required":["user"]},"Entitlement":{"type":"object","properties":{"userId":{"type":"string"},"plan":{"type":"string","enum":["trial","pro","cancelled"]},"status":{"type":"string","enum":["pending","trial","active","trial_expired","cancelled"]},"trialStartedAt":{"type":"string"},"trialEndsAt":{"type":"string"},"trialCallCap":{"type":"number"},"callsUsed":{"type":"number"},"callsLeft":{"type":["number","null"]},"daysLeft":{"type":["number","null"]},"canCall":{"type":"boolean"},"extensionAvailable":{"type":"boolean","description":"Whether the one self-serve trial extension is still available."},"trialExtendedAt":{"type":["string","null"]},"approvedAt":{"type":["string","null"],"description":"Beta: when the account was approved; null while pending."}},"required":["userId","plan","status","trialStartedAt","trialEndsAt","trialCallCap","callsUsed","callsLeft","daysLeft","canCall","extensionAvailable","trialExtendedAt","approvedAt"]},"ApiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"revoked":{"type":"boolean"},"createdAt":{"type":"string"},"lastUsedAt":{"type":["string","null"]}},"required":["id","name","prefix","revoked","createdAt","lastUsedAt"]},"Connection":{"type":"object","properties":{"clientId":{"type":"string"},"clientName":{"type":["string","null"]},"grantedAt":{"type":"string"},"lastUsedAt":{"type":["string","null"]},"expiresAt":{"type":"string"}},"required":["clientId","clientName","grantedAt","lastUsedAt","expiresAt"]},"Account":{"type":"object","properties":{"entitlement":{"$ref":"#/components/schemas/Entitlement"},"keys":{"type":"array","items":{"$ref":"#/components/schemas/ApiKey"}},"usage":{"type":"array","items":{"type":"object","properties":{"surface":{"type":"string"},"tool":{"type":"string"},"calls":{"type":"number"}},"required":["surface","tool","calls"]}},"connections":{"type":"array","items":{"$ref":"#/components/schemas/Connection"},"description":"Assistants signed in through the connector and still holding a token."},"maxKeys":{"type":"number"},"billing":{"type":"object","properties":{"open":{"type":"boolean","description":"Whether this server sells the Founder rate; the checkout route answers 503 otherwise."},"customer":{"type":"boolean","description":"Whether a first checkout happened, so the billing portal has something to show."},"subscription":{"type":["object","null"],"properties":{"status":{"type":"string"},"amount":{"type":"number","description":"In the smallest unit of the currency: 3900 is $39.00."},"currency":{"type":"string"},"interval":{"type":"string"},"currentPeriodEnd":{"type":["string","null"]},"cancelAtPeriodEnd":{"type":"boolean"},"cancelAt":{"type":["string","null"]}},"required":["status","amount","currency","interval","currentPeriodEnd","cancelAtPeriodEnd","cancelAt"],"description":"The live Stripe subscription behind an active plan; null on a trial or when Stripe cannot be reached."}},"required":["open","customer","subscription"]}},"required":["entitlement","keys","usage","connections","maxKeys","billing"]},"KeyCreated":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/ApiKey"},"plaintext":{"type":"string","description":"Shown once; store it now."}},"required":["key","plaintext"]},"KeyInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64}},"required":["name"]},"AlertClause":{"type":"object","properties":{"field":{"type":"string"},"op":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["field","op","values"]},"Alert":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"matchAll":{"type":"boolean"},"criteria":{"type":"array","items":{"$ref":"#/components/schemas/AlertClause"}},"isActive":{"type":"boolean"},"emailEnabled":{"type":"boolean"},"email":{"type":["string","null"]},"createdAt":{"type":"string"},"lastCheckedAt":{"type":["string","null"]},"lastNotifiedAt":{"type":["string","null"]},"matchCount":{"type":"number"}},"required":["id","name","matchAll","criteria","isActive","emailEnabled","email","createdAt","lastCheckedAt","lastNotifiedAt","matchCount"]},"Watchlists":{"type":"object","properties":{"alerts":{"type":"array","items":{"$ref":"#/components/schemas/Alert"}},"max":{"type":"number"},"maxEmailing":{"type":"number"},"email":{"type":["string","null"]}},"required":["alerts","max","maxEmailing","email"]},"AlertPreview":{"type":"object","properties":{"days":{"type":"number"},"count":{"type":"number"},"sample":{"type":"array","items":{"type":"object","properties":{"permitNumber":{"type":["number","null"]},"apiNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"operatorName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"dateIssued":{"type":["string","null"]}},"required":["permitNumber","apiNumber","countyName","operatorName","leaseName","wellNumber","dateIssued"]}}},"required":["days","count","sample"]},"AlertMatches":{"type":"object","properties":{"alert":{"$ref":"#/components/schemas/Alert"},"matches":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"matchedAt":{"type":"string"},"notifiedAt":{"type":["string","null"]},"permitId":{"type":"number"},"permitNumber":{"type":["number","null"]},"apiNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"operatorName":{"type":["string","null"]},"operatorNumber":{"type":["number","null"]},"dateIssued":{"type":["string","null"]},"isHorizontal":{"type":["boolean","null"]},"url":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."},"wellUrl":{"type":["string","null"],"format":"uri","description":"Canonical petrora.com page for this record; cite it."}},"required":["id","matchedAt","notifiedAt","permitId","permitNumber","apiNumber","countyName","leaseName","wellNumber","operatorName","operatorNumber","dateIssued","isHorizontal","url","wellUrl"]}}},"required":["alert","matches"]},"AlertFields":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"object","additionalProperties":{}}},"ops":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"]}}},"districts":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"]}},"applicationTypes":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"]}},"max":{"type":"number"},"maxEmailing":{"type":"number"}},"required":["fields","ops","districts","applicationTypes","max","maxEmailing"]}},"parameters":{}},"paths":{"/v1/data/stats":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Stats"],"summary":"Statewide counts","description":"How much is on file per source, as of the last load. Rebuilt hourly.","operationId":"getDataStats","responses":{"200":{"description":"Counts per source","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}}}}},"/v1/data/permits/tx":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Permits"],"summary":"Permits, newest first","description":"Permits ordered by the day they first appeared in Railroad Commission daily files, which runs a few days behind the issue date. Every filter the site offers; `format=csv` downloads the page as a file.","operationId":"getDataPermitsTx","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Lease or operator name fragment, or an API number prefix (digits)."},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"County name, case-insensitive.","example":"Reeves"},"required":false,"name":"county","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":14,"description":"RRC district as stored on permits: 1–6, 7 = 6E, 8 = 7B, 9 = 7C, 10 = 08, 11 = 8A, 13 = 09, 14 = 10."},"required":false,"name":"district","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"RRC operator number.","example":100852},"required":false,"name":"operator","in":"query"},{"schema":{"type":"string","pattern":"^\\d{2}$","description":"Two-digit application type, e.g. 01 drill, 14 recompletion."},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","enum":["yes","no"],"description":"Horizontal wellbore flag."},"required":false,"name":"hz","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":40000,"description":"Minimum total depth, feet."},"required":false,"name":"minDepth","in":"query"},{"schema":{"anyOf":[{"type":"string","enum":["all"]},{"type":"integer","minimum":1,"maximum":365}],"description":"Window on the day the permit first appeared in daily files, 1–365, or `all` for every permit on file.","example":30},"required":false,"name":"days","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":50,"description":"Rows per page, up to 500."},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000000,"default":0,"description":"Rows to skip; pages through the whole result."},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","enum":["json","csv"],"description":"`csv` returns a file; needs a signed-in bearer token."},"required":false,"name":"format","in":"query"}],"responses":{"200":{"description":"Permits with a total for paging","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Permits"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"CSV without a bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/permits/tx/{number}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Permits"],"summary":"One permit","description":"The current version of a permit with every amendment and the application records behind it.","operationId":"getDataPermitsTxByNumber","parameters":[{"schema":{"type":"string","pattern":"^\\d+$","example":"919491"},"required":true,"name":"number","in":"path"}],"responses":{"200":{"description":"The permit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PermitDetail"}}}},"400":{"description":"Not a permit number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/permits/tx/row/{id}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Permits"],"summary":"Permit number for a legacy row id","description":"The previous Petrora keyed permit pages on a database row id. This resolves one to the RRC permit number and the page URL, so old links can redirect.","operationId":"getDataPermitsTxRowById","parameters":[{"schema":{"type":"string","pattern":"^\\d+$","example":"5452205"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Resolved","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":"number"},"url":{"type":"string","format":"uri"}},"required":["id","permitNumber","url"]}}}},"404":{"description":"No permit with that row id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/wells":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Wells"],"summary":"Wells, one row per API number","description":"Every well with a permit on file, from the permit record, with a production flag and last reported month from the leases it is completed on. Volumes are not per well: Texas reports them by lease.","operationId":"getDataWells","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64,"description":"API number or prefix (with or without the 42 state code), or a lease or operator name fragment."},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"County name, case-insensitive.","example":"Reeves"},"required":false,"name":"county","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":14,"description":"RRC district as stored on permits: 1–6, 7 = 6E, 8 = 7B, 9 = 7C, 10 = 08, 11 = 8A, 13 = 09, 14 = 10."},"required":false,"name":"district","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"RRC operator number.","example":100852},"required":false,"name":"operator","in":"query"},{"schema":{"type":"string","enum":["yes","no"],"description":"Whether the well's leases have reported production."},"required":false,"name":"production","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":40000,"description":"Minimum permitted depth, feet."},"required":false,"name":"minDepth","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":1000},"required":false,"name":"minPermits","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last permit issued on or after this date (YYYY-MM-DD)."},"required":false,"name":"since","in":"query"},{"schema":{"type":"string","enum":["recent","depth","permits"],"default":"recent"},"required":false,"name":"sort","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Rows per page, up to 200."},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000000,"default":0,"description":"Rows to skip; pages through the whole result."},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","enum":["json","csv"],"default":"json","description":"`csv` returns the first 200 rows as a file; needs a signed-in bearer token."},"required":false,"name":"format","in":"query"}],"responses":{"200":{"description":"Wells with a total for paging","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WellsList"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"CSV without a bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/wells/{api}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Wells"],"summary":"One well","description":"Everything on file for an API number: permits, completions, chain of custody, lease production, tops, casing, perforations, injection, seismicity, offset wells. Accepts 8 digits or 42-XXX-XXXXX.","operationId":"getDataWellsByApi","parameters":[{"schema":{"type":"string","example":"42-389-41475"},"required":true,"name":"api","in":"path"}],"responses":{"200":{"description":"The well","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Well"}}}},"400":{"description":"Not an API number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No permits on file","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/wells/{api}/tops.csv":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Wells"],"summary":"Formation tops as CSV","operationId":"getDataWellsByApiTopsCsv","parameters":[{"schema":{"type":"string","example":"4233734003"},"required":true,"name":"api","in":"path"}],"responses":{"200":{"description":"One row per reported top with measured and subsea depth.","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No permits on file","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/data/cross-section":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Wells"],"summary":"Formation tops for several wells side by side","description":"Up to eight wells with every reported top, measured depth and subsea where an elevation is on file. The cross-section page draws these; nothing is interpolated.","operationId":"getDataCrossSection","parameters":[{"schema":{"type":"string","description":"Comma-separated API numbers, 8 digits or 42-XXX-XXXXX.","example":"38941475,38940687,38942345"},"required":true,"name":"apis","in":"query"}],"responses":{"200":{"description":"Wells and tops","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrossSection"}}}},"400":{"description":"No API numbers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/counties/tx":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Counties"],"summary":"Every county with activity","description":"From the nightly county_stats rebuild: 90-day and 365-day permits, operators, horizontal share, depth, and flags for disposal and seismicity pages.","operationId":"getDataCountiesTx","responses":{"200":{"description":"Counties","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Counties"}}}}}}},"/v1/data/counties/tx/{slug}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Counties"],"summary":"One county","operationId":"getDataCountiesTxBySlug","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$","example":"reeves"},"required":true,"name":"slug","in":"path"},{"schema":{"type":["integer","null"],"default":90,"description":"Window in days for the county figures (30, 90, 180, or 365)."},"required":false,"name":"days","in":"query"}],"responses":{"200":{"description":"The county hub","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountyDetail"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/counties/tx/{slug}/operators":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Counties"],"summary":"Operators in a county","description":"Every operator with a permit on file or a well of record in the county, ranked by permits in the window, with all-time permits and current wells there. The 300 most active, with the full count.","operationId":"getDataCountiesTxBySlugOperators","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$","example":"reeves"},"required":true,"name":"slug","in":"path"},{"schema":{"anyOf":[{"type":"string","enum":["all"]},{"type":"integer","minimum":1,"maximum":3650}],"description":"Window on the permit issue date, up to 3650 days, or `all`.","example":365},"required":false,"name":"days","in":"query"}],"responses":{"200":{"description":"Operators","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountyOperators"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/operators/tx":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Operators"],"summary":"Operators: active ranking or the whole directory","description":"Default: operators with permits in the window, ranked, with the prior window for comparison. `view=all`: every operator number on record, sortable and paged. `q` searches names in either view.","operationId":"getDataOperatorsTx","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"Name fragment."},"required":false,"name":"q","in":"query"},{"schema":{"type":["integer","null"],"default":90,"description":"Ranking window for the active view: 30, 90, 180, or 365."},"required":false,"name":"days","in":"query"},{"schema":{"type":"string","enum":["active","all"],"default":"active","description":"`active` ranks operators with permits in the window; `all` is the whole directory, sortable and paged."},"required":false,"name":"view","in":"query"},{"schema":{"type":"string","enum":["permits","wells","recent","name"],"default":"permits","description":"For view=all: permits on file, wells of record, latest permit, or name."},"required":false,"name":"sort","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":50,"description":"Rows per page, up to 500."},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000000,"default":0,"description":"Rows to skip; pages through the whole result."},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Operators","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operators"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/operators/tx/sitemap":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Operators"],"summary":"Every operator with a permit on file","description":"Numbers, last permit dates, and page URLs only; what the site's sitemap is built from. About 27,000 rows, cached for an hour.","operationId":"getDataOperatorsTxSitemap","responses":{"200":{"description":"Operators","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"number"},"operators":{"type":"array","items":{"type":"object","properties":{"operatorNumber":{"type":"number"},"lastIssued":{"type":["string","null"]},"url":{"type":"string","format":"uri"}},"required":["operatorNumber","lastIssued","url"]}}},"required":["count","operators"]}}}}}}},"/v1/data/operators/tx/{number}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Operators"],"summary":"One operator","description":"Stats record, P-5 registration, wells by status, permit-to-spud scorecard, counties, formations, monthly permits and production, and the last year of permits.","operationId":"getDataOperatorsTxByNumber","parameters":[{"schema":{"type":"string","pattern":"^\\d+$","description":"RRC operator number","example":"100852"},"required":true,"name":"number","in":"path"}],"responses":{"200":{"description":"The operator hub","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operator"}}}},"400":{"description":"Not an operator number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/operators/tx/{number}/permits":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Operators"],"summary":"An operator's permits","operationId":"getDataOperatorsTxByNumberPermits","parameters":[{"schema":{"type":"string","pattern":"^\\d+$","description":"RRC operator number","example":"100852"},"required":true,"name":"number","in":"path"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":3650,"default":0,"description":"Window on the issue date; 0 for all time."},"required":false,"name":"days","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"County name, case-insensitive.","example":"Reeves"},"required":false,"name":"county","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":32,"description":"Application type code (permits) or well type name (wells)."},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"Exact RRC field name as filed (wells only)."},"required":false,"name":"field","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"Lease name fragment."},"required":false,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Rows per page, up to 200."},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000000,"default":0,"description":"Rows to skip; pages through the whole result."},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Permits with a total","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorPermits"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/operators/tx/{number}/wells":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Operators"],"summary":"An operator's wells of record","description":"From the RRC wellbore schedule, which is where the current operator is recorded.","operationId":"getDataOperatorsTxByNumberWells","parameters":[{"schema":{"type":"string","pattern":"^\\d+$","description":"RRC operator number","example":"100852"},"required":true,"name":"number","in":"path"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":3650,"default":0,"description":"Window on the issue date; 0 for all time."},"required":false,"name":"days","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"County name, case-insensitive.","example":"Reeves"},"required":false,"name":"county","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":32,"description":"Application type code (permits) or well type name (wells)."},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"Exact RRC field name as filed (wells only)."},"required":false,"name":"field","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"Lease name fragment."},"required":false,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Rows per page, up to 200."},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000000,"default":0,"description":"Rows to skip; pages through the whole result."},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Wells with a total","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorWells"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/operators/tx/{number}/counties/{slug}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Operators"],"summary":"One operator in one county","operationId":"getDataOperatorsTxByNumberCountiesBySlug","parameters":[{"schema":{"type":"string","pattern":"^\\d+$","description":"RRC operator number","example":"100852"},"required":true,"name":"number","in":"path"},{"schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$","example":"reeves"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"The drill-down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorCounty"}}}},"404":{"description":"No permits for that operator there","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/fields/tx":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Fields"],"summary":"RRC fields","description":"Every named field with a lease report, from the field summary: leases, operators, lifetime oil and gas, last report. Search by name, filter by district.","operationId":"getDataFieldsTx","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"Field name fragment."},"required":false,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":14,"description":"RRC district as stored on permits: 1–6, 7 = 6E, 8 = 7B, 9 = 7C, 10 = 08, 11 = 8A, 13 = 09, 14 = 10."},"required":false,"name":"district","in":"query"},{"schema":{"type":"string","enum":["oil","gas","leases","recent","name"],"default":"oil"},"required":false,"name":"sort","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Rows per page, up to 200."},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000000,"default":0,"description":"Rows to skip; pages through the whole result."},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Fields with a total","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fields"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/fields/tx/{no}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Fields"],"summary":"One field","description":"Counties and operators from the field's leases, a ten-year monthly series, and the last twelve months against the prior twelve.","operationId":"getDataFieldsTxByNo","parameters":[{"schema":{"type":"string","pattern":"^\\d+$","description":"RRC field number","example":"85280300"},"required":true,"name":"no","in":"path"}],"responses":{"200":{"description":"The field","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Field"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/map/permits":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Map"],"summary":"Permit points","description":"Every permit the filters match that carries a location, as compact rows for plotting. Locations come from the daily permit files, so older permits are often unplaced; `located` against `total` says how many.","operationId":"getDataMapPermits","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Lease or operator name fragment, or an API number prefix (digits)."},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"County name, case-insensitive.","example":"Reeves"},"required":false,"name":"county","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":14,"description":"RRC district as stored on permits: 1–6, 7 = 6E, 8 = 7B, 9 = 7C, 10 = 08, 11 = 8A, 13 = 09, 14 = 10."},"required":false,"name":"district","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"RRC operator number.","example":100852},"required":false,"name":"operator","in":"query"},{"schema":{"type":"string","pattern":"^\\d{2}$","description":"Two-digit application type, e.g. 01 drill, 14 recompletion."},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","enum":["yes","no"],"description":"Horizontal wellbore flag."},"required":false,"name":"hz","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":40000,"description":"Minimum total depth, feet."},"required":false,"name":"minDepth","in":"query"},{"schema":{"anyOf":[{"type":"string","enum":["all"]},{"type":"integer","minimum":1,"maximum":365}],"description":"Window on the day the permit first appeared in daily files, 1–365, or `all` for every permit on file.","example":30},"required":false,"name":"days","in":"query"}],"responses":{"200":{"description":"Permit points","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapPermits"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/map/disposal":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Map"],"summary":"Disposal well points","description":"Active UIC disposal and injection permits with a location, statewide, in one county, or for one operator.","operationId":"getDataMapDisposal","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"County name, case-insensitive.","example":"Reeves"},"required":false,"name":"county","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"RRC operator number.","example":100852},"required":false,"name":"operator","in":"query"}],"responses":{"200":{"description":"Disposal points","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapDisposal"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/map/earthquakes":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Map"],"summary":"Earthquake points","description":"TexNet events over a window or the whole catalogue, at or above a magnitude or within one whole-magnitude band.","operationId":"getDataMapEarthquakes","parameters":[{"schema":{"anyOf":[{"type":"string","enum":["all"]},{"type":"integer","minimum":1,"maximum":3650}],"description":"Window on event time in days, or `all` for the whole catalogue since 2017.","example":365},"required":false,"name":"days","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":6,"default":2,"description":"Minimum magnitude; ignored when `band` is given.","example":2},"required":false,"name":"mag","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":9,"description":"One whole-magnitude band instead of a floor: 2 is M2.0 to M2.9.","example":3},"required":false,"name":"band","in":"query"}],"responses":{"200":{"description":"Event points","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapEarthquakes"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/basins":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Basins"],"summary":"The six basins","description":"Search-shaped groupings of RRC districts (Permian, Eagle Ford, Gulf Coast, East Texas, Barnett, Panhandle) with 90-day and 12-month permit counts, operators, disposal, and seismicity rolled up from the county figures.","operationId":"getDataBasins","responses":{"200":{"description":"Basins","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basins"}}}}}}},"/v1/data/basins/{slug}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Basins"],"summary":"One basin","description":"Every county in the basin, the operators permitting there over two years, a five-year monthly timeline, and the latest permits.","operationId":"getDataBasinsBySlug","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$","example":"permian"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"The basin hub","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basin"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/formations":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Formations"],"summary":"Formations with at least 25 wells reporting a top","operationId":"getDataFormations","responses":{"200":{"description":"Formations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Formations"}}}}}}},"/v1/data/formations/{slug}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Formations"],"summary":"One formation","operationId":"getDataFormationsBySlug","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$","example":"wolfcamp"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"The formation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Formation"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/leases/tx":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Leases"],"summary":"Leases, the unit Texas reports production by","description":"From the PDQ lease summary. A lease is in every county its completed wells are in, because lease reports leave the county blank.","operationId":"getDataLeasesTx","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"Lease, operator, or field name fragment."},"required":false,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":14,"description":"RRC district as stored on permits: 1–6, 7 = 6E, 8 = 7B, 9 = 7C, 10 = 08, 11 = 8A, 13 = 09, 14 = 10."},"required":false,"name":"district","in":"query"},{"schema":{"type":"string","enum":["O","G"],"description":"Oil or gas lease."},"required":false,"name":"type","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"RRC operator number.","example":100852},"required":false,"name":"operator","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":64,"description":"County name; a lease is in every county its completed wells are in.","example":"Reeves"},"required":false,"name":"county","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"RRC field number."},"required":false,"name":"field","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000,"description":"Minimum cumulative oil, barrels."},"required":false,"name":"minOil","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":10000,"description":"Minimum wells completed on the lease."},"required":false,"name":"minWells","in":"query"},{"schema":{"type":"string","enum":["oil","gas","wells","recent"],"default":"oil"},"required":false,"name":"sort","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Rows per page, up to 200."},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000000,"default":0,"description":"Rows to skip; pages through the whole result."},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Leases with a total","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Leases"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/leases/tx/{id}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Leases"],"summary":"One lease","description":"Monthly history to the statewide reported-through month, operator runs, wells, and a decline model when the last ten years follow one curve.","operationId":"getDataLeasesTxById","parameters":[{"schema":{"type":"string","description":"type-district-lease","example":"o-10-64741"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The lease","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lease"}}}},"400":{"description":"Not a lease id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/leases/tx/{id}/wells":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Leases"],"summary":"Wells completed on a lease","operationId":"getDataLeasesTxByIdWells","parameters":[{"schema":{"type":"string","example":"o-10-64741"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64,"description":"API number prefix or well number."},"required":false,"name":"q","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"RRC operator number.","example":100852},"required":false,"name":"operator","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Well status from the wellbore file, e.g. PRODUCING."},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Rows per page, up to 200."},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":10000000,"default":0,"description":"Rows to skip; pages through the whole result."},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Wells with a total","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaseWells"}}}},"400":{"description":"Bad query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/water/tx":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Water"],"summary":"Produced water and disposal, statewide","description":"UIC permits, H-10 injected volumes at the last settled month, TexNet daily deep-disposal volumes, counties, and operators.","operationId":"getDataWaterTx","responses":{"200":{"description":"The water hub","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Water"}}}}}}},"/v1/data/water/tx/{slug}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Water"],"summary":"Disposal in one county","operationId":"getDataWaterTxBySlug","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$","example":"reeves"},"required":true,"name":"slug","in":"path"},{"schema":{"type":"integer","minimum":1,"default":1,"description":"Page of the well list, 100 a page, active permits first.","example":1},"required":false,"name":"page","in":"query"}],"responses":{"200":{"description":"The county","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaterCounty"}}}},"404":{"description":"No injection permits on file there","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/earthquakes/tx":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Earthquakes"],"summary":"TexNet events, statewide","operationId":"getDataEarthquakesTx","responses":{"200":{"description":"The earthquakes hub","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Earthquakes"}}}}}}},"/v1/data/earthquakes/tx/{slug}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Earthquakes"],"summary":"Events in one county area","description":"The catalog carries no county, so events are counted inside the county's located-permit bounding box.","operationId":"getDataEarthquakesTxBySlug","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{2,64}$","example":"culberson"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"The area","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarthquakeArea"}}}},"404":{"description":"No located permits there","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/data/earthquakes/tx/events/{id}":{"get":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Earthquakes"],"summary":"One event","description":"With the events and active injection wells within 10 km. Proximity, not attribution.","operationId":"getDataEarthquakesTxEventsById","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9]{4,32}$","example":"tx2026vgingz"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarthquakeEvent"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/me":{"get":{"security":[{"bearerAuth":[]}],"tags":["Account"],"summary":"The signed-in user","operationId":"getAppMe","responses":{"200":{"description":"User","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Me"}}}},"401":{"description":"Not signed in","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/account":{"get":{"security":[{"bearerAuth":[]}],"tags":["Account"],"summary":"Your plan, trial, API keys, connected assistants, and usage","description":"The entitlement every API and connector call is checked against: trial days and calls left, or the paid plan; your keys; the assistants signed in through the connector; calls by tool over 30 days.","operationId":"getAppAccount","responses":{"200":{"description":"Account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}}},"401":{"description":"Not signed in","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/account/keys":{"post":{"security":[{"bearerAuth":[]}],"tags":["Account"],"summary":"Create an API key","description":"The key is returned once, in plaintext, and never again.","operationId":"postAppAccountKeys","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyInput"}}}},"responses":{"201":{"description":"The key, shown once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyCreated"}}}},"401":{"description":"Not signed in","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Too many active keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/account/keys/{id}":{"delete":{"security":[{"bearerAuth":[]}],"tags":["Account"],"summary":"Revoke an API key","operationId":"deleteAppAccountKeysById","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Revoked","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}},"404":{"description":"No such key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/account/connections/{clientId}":{"delete":{"security":[{"bearerAuth":[]}],"tags":["Account"],"summary":"Disconnect an assistant","description":"Revokes every token the connector issued to that client for you; it has to sign in again to continue.","operationId":"deleteAppAccountConnectionsByClientId","parameters":[{"schema":{"type":"string"},"required":true,"name":"clientId","in":"path"}],"responses":{"200":{"description":"Disconnected","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/v1/app/account/trial/extend":{"post":{"security":[{"bearerAuth":[]}],"tags":["Account"],"summary":"Extend your trial once","description":"Adds a fixed number of days and calls to a trial account, one time. For more, write to contact@petrora.com.","operationId":"postAppAccountTrialExtend","responses":{"200":{"description":"Extended","content":{"application/json":{"schema":{"type":"object","properties":{"entitlement":{"$ref":"#/components/schemas/Entitlement"},"added":{"type":"object","properties":{"days":{"type":"number"},"calls":{"type":"number"}},"required":["days","calls"]}},"required":["entitlement","added"]}}}},"409":{"description":"Already extended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/account/billing/checkout":{"post":{"security":[{"bearerAuth":[]}],"tags":["Account"],"summary":"Start Stripe checkout for the Founder rate","description":"Returns the URL of a Stripe-hosted checkout page for the monthly Founder price. 409 when the account already has it; 503 while billing is not open.","operationId":"postAppAccountBillingCheckout","responses":{"200":{"description":"The checkout page to send the browser to","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}}}},"401":{"description":"Not signed in","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Already on the Founder rate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Billing not open","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/account/billing/portal":{"post":{"security":[{"bearerAuth":[]}],"tags":["Account"],"summary":"Open the Stripe billing portal","description":"Returns the URL of the Stripe customer portal: card, invoices, cancellation. 404 before a first checkout.","operationId":"postAppAccountBillingPortal","responses":{"200":{"description":"The portal page to send the browser to","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}}}},"401":{"description":"Not signed in","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No billing account yet","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Billing not open","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/billing/webhook":{"post":{"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"tags":["Account"],"summary":"Stripe webhook","description":"Called by Stripe, not by you: verified by the Stripe-Signature header over the raw body. Subscription events are written to the account; everything else is acknowledged.","operationId":"postAppBillingWebhook","responses":{"200":{"description":"Acknowledged","content":{"application/json":{"schema":{"type":"object","properties":{"received":{"type":"boolean"},"handled":{"type":"boolean"}},"required":["received","handled"]}}}},"400":{"description":"Bad signature","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Webhook not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/alerts":{"get":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"Your watchlists","operationId":"getAppAlerts","responses":{"200":{"description":"Watchlists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Watchlists"}}}},"401":{"description":"Not signed in","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"Create a watchlist","description":"A saved permit search. With `emailEnabled`, one email a day lists new permits that matched; up to five watchlists per account can email.","operationId":"postAppAlerts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":["string","null"],"maxLength":128},"matchAll":{"type":"boolean","default":false},"criteria":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"op":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["field","op","values"]},"maxItems":20,"default":[]},"emailEnabled":{"type":"boolean","default":true}}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"alert":{"$ref":"#/components/schemas/Alert"}},"required":["alert"]}}}},"400":{"description":"Bad alert or limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Not signed in","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/alerts/preview":{"post":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"Size a watchlist before saving it","description":"How many permits the criteria would have matched in the last 30 days, with a sample.","operationId":"postAppAlertsPreview","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"matchAll":{"type":"boolean","default":false},"criteria":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"op":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["field","op","values"]},"maxItems":20,"default":[]}}}}}},"responses":{"200":{"description":"Preview","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertPreview"}}}},"400":{"description":"Bad criteria","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Not signed in","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/alerts/{id}":{"get":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"One watchlist","operationId":"getAppAlertsById","parameters":[{"schema":{"type":"string","pattern":"^\\d{1,9}$","example":"12"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Alert","content":{"application/json":{"schema":{"type":"object","properties":{"alert":{"$ref":"#/components/schemas/Alert"}},"required":["alert"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"Replace a watchlist","operationId":"putAppAlertsById","parameters":[{"schema":{"type":"string","pattern":"^\\d{1,9}$","example":"12"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":["string","null"],"maxLength":128},"matchAll":{"type":"boolean","default":false},"criteria":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"op":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["field","op","values"]},"maxItems":20,"default":[]},"emailEnabled":{"type":"boolean","default":true}}}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"alert":{"$ref":"#/components/schemas/Alert"}},"required":["alert"]}}}},"400":{"description":"Bad alert","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"Turn a watchlist's email on or off, or pause it","operationId":"patchAppAlertsById","parameters":[{"schema":{"type":"string","pattern":"^\\d{1,9}$","example":"12"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"isActive":{"type":"boolean"},"emailEnabled":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"alert":{"$ref":"#/components/schemas/Alert"}},"required":["alert"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"Delete a watchlist","operationId":"deleteAppAlertsById","parameters":[{"schema":{"type":"string","pattern":"^\\d{1,9}$","example":"12"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"]}}}}}}},"/v1/app/alerts/{id}/permits":{"get":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"The permits a watchlist matches right now","description":"Runs the watchlist's criteria live against the permit record, newest first, over a window on the issue date (`days`, or `all`).","operationId":"getAppAlertsByIdPermits","parameters":[{"schema":{"type":"string","pattern":"^\\d{1,9}$","example":"12"},"required":true,"name":"id","in":"path"},{"schema":{"anyOf":[{"type":"string","enum":["all"]},{"type":"integer","minimum":1,"maximum":3650}],"description":"Window on the issue date, or `all`.","example":365},"required":false,"name":"days","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Permits with a total","content":{"application/json":{"schema":{"type":"object","properties":{"alert":{"$ref":"#/components/schemas/Alert"},"query":{"type":"object","additionalProperties":{}},"total":{"type":"number"},"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"permitNumber":{"type":["number","null"]},"apiNumber":{"type":["string","null"]},"countyName":{"type":["string","null"]},"district":{"type":["number","null"]},"operatorNumber":{"type":["number","null"]},"operatorName":{"type":["string","null"]},"leaseName":{"type":["string","null"]},"wellNumber":{"type":["string","null"]},"applicationType":{"type":["string","null"]},"totalDepth":{"type":["number","null"]},"isHorizontal":{"type":["boolean","null"]},"dateIssued":{"type":["string","null"]},"firstSeenAt":{"type":["string","null"]},"url":{"type":["string","null"]},"wellUrl":{"type":["string","null"]},"operatorUrl":{"type":["string","null"]}},"required":["id","permitNumber","apiNumber","countyName","district","operatorNumber","operatorName","leaseName","wellNumber","applicationType","totalDepth","isHorizontal","dateIssued","firstSeenAt","url","wellUrl","operatorUrl"]}}},"required":["alert","query","total","rows"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/alerts/{id}/matches":{"get":{"security":[{"bearerAuth":[]}],"tags":["Watchlists"],"summary":"What the daily email has reported for a watchlist","operationId":"getAppAlertsByIdMatches","parameters":[{"schema":{"type":"string","pattern":"^\\d{1,9}$","example":"12"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Matches, newest first, up to 100","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertMatches"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/app/alerts-fields":{"get":{"security":[],"tags":["Watchlists"],"summary":"The watchlist builder vocabulary","operationId":"getAppAlertsFields","responses":{"200":{"description":"Fields, operators, districts, application types","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertFields"}}}}}}},"/v1/app/alerts-unsubscribe":{"get":{"security":[],"tags":["Watchlists"],"summary":"One-click unsubscribe from digest emails","operationId":"getAppAlertsUnsubscribe","parameters":[{"schema":{"type":"string"},"required":true,"name":"token","in":"query"}],"responses":{"200":{"description":"Unsubscribed","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"email":{"type":"string"}},"required":["ok","email"]}}}},"404":{"description":"Token not valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"webhooks":{}}