Helmerich & Payne

Helmerich & Payne Survey Validation Controller API

Survey Validation and QC

Documentation GitHub OpenAPI

Business capability

Drilling & Wells Management BC-3020

Operations 1

GET /uncertaintyValues Obtain survey validation info #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/helmerich-and-payne:helmerich-and-payne-survey-validation-controller-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: This web API implements dynamic quality control for the ISCWSA OWSG Rev-2 error model tool codes.
  title: MagVAR Survey Validation Survey Validation Controller API
  contact:
    name: Magnetic Variation Services LLC
    url: https://www.magvar.com
    email: support@magvar.com
  license:
    name: End User License Agreement (EULA)
    url: https://www.magvar.com/EULA_SurveyValidationAPI.html
servers:
- url: https://fac-api.magvar.com/
tags:
- name: survey-validation-controller
  description: Survey Validation and QC
paths:
  /uncertaintyValues:
    get:
      tags:
      - survey-validation-controller
      summary: Obtain survey validation info
      operationId: uncertaintyValuesUsingGET
      parameters:
      - name: antiCollisionSigma
        in: query
        description: Sigma used for Anti-collision
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 2.0
      - name: bTotalUnits
        in: query
        description: Btotal Units
        required: true
        allowEmptyValue: false
        schema:
          type: string
          enum:
          - NANOTESLA
          - MICROTESLA
          - MILLITESLA
          - TESLA
          - GAUSS
          - GAMMA
          default: NANOTESLA
      - name: depthBelowMSL
        in: query
        description: 'Depth below MSL (negative values for above MSL).<br/>Range: -20000 to 60000'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: -200.0
      - name: depthUnits
        in: query
        description: Depth Units
        required: true
        allowEmptyValue: false
        schema:
          type: string
          enum:
          - METER
          - KILOMETER
          - FOOT
          - FOOT_US
          - YARD
          - MILE
          - SE_FT
          default: METER
      - name: gTotalUnits
        in: query
        description: Gravity Units
        required: true
        allowEmptyValue: false
        schema:
          type: string
          enum:
          - M_PER_SEC_SQ
          - FT_PER_SEC_SQ
          - G
          - MILLI_G
          - G_98
          - GAL
          - MILLI_GAL
          default: M_PER_SEC_SQ
      - name: gravityModel
        in: query
        description: Reference Gravity Model
        required: true
        allowEmptyValue: false
        schema:
          type: string
          enum:
          - OLD_STYLE
          - STANDARD_TOTALG
          - GARM_TOTALG
          default: GARM_TOTALG
      - name: latitude
        in: query
        description: 'WGS84 Latitude<br/>Range: -90 to 90'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 29.4217
      - name: longitude
        in: query
        description: 'WGS84 Longitude<br/>Range: -180 to 360'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: -98.4838
      - name: measuredBTotal
        in: query
        description: 'Measured Btotal<br/>Range: 0 to 80000'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 46475.6
      - name: measuredDip
        in: query
        description: 'Measured Dip<br/>Range: -90 to 90'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 57.96
      - name: measuredGTotal
        in: query
        description: 'Measured Gtotal<br/>Range: 0 to 2000000'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 9.803
      - name: referenceBTotal
        in: query
        description: 'Reference Btotal<br/>Range: 0 to 80000'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 46644.9
      - name: referenceDeclination
        in: query
        description: 'Reference Declination<br/>Range: -180 to 360'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 4.24
      - name: referenceDip
        in: query
        description: 'Reference Dip<br/>Range: -90 to 90'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 58.04
      - name: referenceGTotal
        in: query
        description: 'Reference Gtotal<br/>Range: 0 to 2000000'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 9.8
      - name: surveyDate
        in: query
        description: Survey date
        required: true
        allowEmptyValue: false
        schema:
          type: string
          format: date-time
          default: 2017-10-12T11:00:00.000-0600
      - name: toolCode
        in: query
        description: Tool code chosen from the ISCWSA Rev2 standard and extended sets
        required: true
        allowEmptyValue: false
        schema:
          type: string
          enum:
          - MWD
          - MWD_AX
          - MWD_AX_SAG
          - MWD_HRGM
          - MWD_HRGM_AX
          - MWD_HRGM_AX_SAG
          - MWD_HRGM_SAG
          - MWD_HRGM_SAG_MS
          - MWD_IFR1
          - MWD_IFR1_AX
          - MWD_IFR1_AX_SAG
          - MWD_IFR1_MS
          - MWD_IFR1_SAG
          - MWD_IFR1_SAG_MS
          - MWD_IFR2_AX_SAG
          - MWD_IFR2_SAG
          - MWD_IFR2_SAG_MS
          - MWD_IGRF
          - MWD_IGRF_AX
          - MWD_IGRF_AX_SAG
          - MWD_IGRF_SAG
          - MWD_SAG
          default: MWD
      - name: wellboreAzimuth
        in: query
        description: 'Wellbore True Azimuth<br/>Range: -180 to 360'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 45.0
      - name: wellboreInclination
        in: query
        description: 'Wellbore Inclination<br/>Range: 0 to 180'
        required: true
        allowEmptyValue: false
        schema:
          type: number
          format: double
          default: 45.0
      responses:
        '200':
          description: Successfully retrieved survey validation info
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/SurveyValidation'
        '400':
          description: Unexpected or invalid data in request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ValidationErrors'
        '500':
          description: Internal server error
      deprecated: false
components:
  schemas:
    SurveyValidation:
      type: object
      required:
      - azimuthUncertainty
      - dip
      - gravitationalFieldStrength
      - inclinationUncertainty
      - magneticFieldStrength
      - sigmaValidation
      properties:
        azimuthUncertainty:
          description: Azimuth uncertainty
          $ref: '#/components/schemas/Uncertainty_results'
        dip:
          description: Dip validation result
          $ref: '#/components/schemas/Validation_results'
        gravitationalFieldStrength:
          description: Gtotal validation result
          $ref: '#/components/schemas/Validation_results'
        inclinationUncertainty:
          description: Inclination uncertainty
          $ref: '#/components/schemas/Uncertainty_results'
        magneticFieldStrength:
          description: Btotal validation result
          $ref: '#/components/schemas/Validation_results'
        sigmaValidation:
          description: Sigma validation result
          $ref: '#/components/schemas/Sigma_results'
      title: SurveyValidation
      description: Survey Validation Info
    ValidationError:
      type: object
      properties:
        field:
          type: string
          example: latitude
        message:
          type: string
          example: Must be between -90 and 90 degrees
        value:
          type: object
          example: 99999
      title: ValidationError
    Validation_results:
      type: object
      required:
      - greenThreshold
      - orangeThreshold
      - validationResult
      properties:
        greenThreshold:
          type: number
          format: double
          description: Green threshold
        orangeThreshold:
          type: number
          format: double
          description: Orange threshold
        validationResult:
          type: string
          description: Validation result
          enum:
          - Green
          - Orange
          - Red
      title: Validation results
    Uncertainty_results:
      type: object
      required:
      - random
      - systematic
      properties:
        random:
          type: number
          format: double
          description: Random uncertainty
        systematic:
          type: number
          format: double
          description: Systematic uncertainty
      title: Uncertainty results
    Sigma_results:
      type: object
      required:
      - distance
      - withinTolerance
      properties:
        distance:
          type: number
          format: double
          description: Calculated sigmaValidation distance
        withinTolerance:
          type: boolean
          description: Whether or not the calculated sigmaValidation is within anti-collision sigmaValidation
      title: Sigma results
    ValidationErrors:
      type: object
      properties:
        validationErrors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
      title: ValidationErrors
x-provenance:
  method: harvested
  publisher: Helmerich & Payne
  source: https://fac-api.magvar.com/v2/api-docs
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)