/TILs#

Warning

Deprecation Notice for Hyperion API v3 - We are deprecating Hyperion API v3 to concentrate on the improved functionality of newer versions. V3 will no longer receive new features or enhancements.

New Integrations: Please use Hyperion API v4.

Existing v3 Users: We encourage you to migrate to v4.

SynMax will provide migration guides and proactive support to assist with your transition.

This endpoint returns status of wellpads which are being monitored for Turn-In-Line (TIL) events. It includes wellpads identified as having a delayed TIL (DTIL) status, as well as those without delays.

Warning

A throttling mechanism with a rate limit of 300 requests per minute has been implemented for this endpoint. This is temporary and may be adjusted in the future.

Endpoint#

GET

https://hyperion.api.synmax.com/v3/tils

Usage#

Python#

client.fetch_tils()#

Returns number of DTIL wells on a wellpad, the operator name, frac job date and the til_date.

This function takes no parameters.

Object returned is a pandas DataFrame.

Note

To learn how to setup and use Python client, refer to Setup and Usage .

Response#

Parameter

Type

Description

Example

bcfd

float

The total expected production from the DTIL wells on the wellpad

0.087

frac_end

string

The date the frac job ended for the DTIL wells, if NULL then the wells have not completed fracking - Date formatting - [“YYYY-MM-DD”]

“2023-08-26”

operator_name

string

Operator of the wellpad.

“CHK”

sub_region

string

Aggregation of several counties, typically representing a major producing basin.

“S LA”

til_date

string

The date the wells were TILd, if NULL then the wells are currently DTILs - Date formatting - [“YYYY-MM-DD”]

“2023-10-06”

wellpad_id

string

Identifier of the wellpad.

“27248”

wells

integer

The number of DTIL wells on the wellpad

2


Responses#

Normal Output#

bcfd

frac_end

operator_name

sub_region

til_date

wellpad_id

wells

0.042

2024-02-05

CHK

Haynesville - LA

2024-07-24

460260

3

0.087

2024-02-10

CHK

NE PA

2024-10-17

474699

3

0.108

2024-02-20

CHK

NE PA

2024-07-03

453480

4

0.105

2024-02-20

CHK

NE PA

2024-07-24

478279

3

0.044

2024-04-05

CHK

Haynesville - LA

2024-07-24

412674

2

0.063

2024-08-05

CHK

Haynesville - LA

2024-09-10

479553

3

Note

Output data will return as “null” when input data is invalid or does not exist.