API V1 - JobHeaders

https://api.welldatalabs.com/jobheaders

JobHeader Object

{
    "jobId": "b332c113-3397-4379-8ab7-302efc3ae949",
    "wellId": "8d206684-e725-44ca-8235-80ef567804ba",
    "wellName": "Sample Ball-and-Sleeve",
    "api": "05-123-00000-00-00",
    "jobStartDate": "2015-01-01T12:00:00",
    "serviceCompany": "Demo Service Company",
    "fleet": "WDL Demo Fleet",
    "operator": "WDL Demo Operator",
    "assetGroup": "WDL Demo Asset Group",
    "formation": "Sample",
    "jobType": "Initial Completion",
    "fracSystem": "Ball and Sleeve",
    "fluidSystem": "Slickwater",
    "bottomholeLatitude": 40.346239,
    "bottomholeLongitude": -104.258837,
    "lateralLength": 5962,
    "lateralLengthUnitText": "feet",
    "measuredDepth": 12890,
    "measuredDepthUnitText": "feet",
    "VerticalDepth": 7177,
    "VerticalDepthUnitText": "feet",
    "stageCount": 6,
    "plannedStages": 6,
    "padName": "Sample Pad",
    "county": "Weld",
    "state": "CO",
    "surfaceLatitude": 40.338484,
    "surfaceLongitude": -104.256738,
    "legalDescription": "\"Township/ Range / Section or other legal information can go here.\"",
    "modifiedUtc": "2017-06-20T15:09:06"
}

HTTP Response Status Codes

Status Code	Description
200	Successful request and data was returned in the body
404	No results found. Note that the endpoint was found, we just didn't find any data matching the criteria.
500	Unexpected error

GET https://api.welldatalabs.com/jobheaders

A GET request to the base endpoint with no Id parameter will return an array of JobHeader objects for all jobs.

curl https://api.welldatalabs.com/jobheaders --header "Authorization: Bearer b+S15uKWEK0lFU+NomEmvekn8yk/ALTTBAYOJalVKrI="

GET https://api.welldatalabs.com/jobheaders/{Id},{Id},{Id}

A GET request that includes a list of one or more Id parameters will return an array of JobHeader objects for all jobs that match the given Ids. Each Id can be either a well API Number or a Well Data Labs Job Id or Well Id. If any of the Ids represent the same job, only one instance of the job header is returned.

Multiple job headers might be returned for a single well API Number if multiple jobs exist for that well. It's possible to have more than one job (multiple fracs or a refrac) for a single well.

curl https://api.welldatalabs.com/jobheaders/05-123-00000-00-00 --header "Authorization: Bearer b+S15uKWEK0lFU+NomEmvekn8yk/ALTTBAYOJalVKrI="

Id Parameters

Parameter	Description
API Number	Well API Number; e.g. 05-123-00000-00-00
JobId	Well Data Labs assigned Job Id; e.g. b332c113-3397-4379-8ab7-302efc3ae949
WellId	Well Data Labs assigned Well Id; e.g. 8d206684-e725-44ca-8235-80ef567804ba

GET https://api.welldatalabs.com/jobheaders?fromChangeUtc={datetime}&toChangeUtc={datetime}

A GET request to the base endpoint with optional fromChangeUtc and toChangeUtc parameters will return an array of JobHeader objects for all jobs and match the given timeframe.

curl https://api.welldatalabs.com/jobheaders?fromChangeUtc=2017-08-15T17:04:58&toChangeUtc=2017-08-15T17:05:59 --header "Authorization: Bearer b+S15uKWEK0lFU+NomEmvekn8yk/ALTTBAYOJalVKrI="

Change Date Parameters*

Parameter	Description
fromChangeUtc={datetime}	Returns results for all jobs with changes greater than or equal to this parameter value.
toChangeUtc={datetime}	Returns results for all jobs with changes less than or equal to this parameter value.
fromChangeUtc={datetime}&toChangeUtc={datetime}	Returns results for all jobs with changes between and including the fromChangeUtc and toChangeUtc.

*The ChangeUtc parameters include milliseconds. Parameter values will be matched to the millisecond. If not all expected results are returned, increase or decrease the parameter value by one second.