NAV
HTTP cURL

Introduction

This documentation describes Solo REST API which provides access to Solo objects. Using Solo REST API, you can easily create your own powerful integration.

Your use of the Solo REST API is subject to this License Agreement

Access Solo REST API

To access Solo REST API you must issue token.

API URL

Once you have a token you can use this URL to access Solo objects. Pass the token in the Authorization: Bearer <access_token> header of every request.

https://solo.cloud/public/api/v1/

Solo objects

Solo objects in Solo REST API are presented in the same hierarchy as is Starsteer. The top level is Project, with the following structure:

Double values

Has a value

HTTP/1.1 200 OK

"data" : {
  "val" : 16.581
}

Not a number value

HTTP/1.1 200 OK

"data" : {
  "undefined": true
}

Double value consists of two fields:

  1. val - field holds a value
  2. undefined - field which is true if a value is not a number value

A response contains only one of the two fields. In requests, send {"undefined": true} for a not a number value. Most endpoints also treat an object without val as a not a number value, but image log data upload rejects it with 400.

Paging

HTTP/1.1 200 OK

{
  "content" : [ ],
  "offset" : 0,
  "limit" : 20,
  "first" : true,
  "last" : true,
  "total" : 3
}

Many of the Solo REST API endpoints return a pageable structure:

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
total Number Total number of records

The range is set by the offset and limit query parameters, most paged endpoints require both of them and reject a request without them with 400. A negative offset is treated as 0, a limit of 0 or less means the default of 100, and a limit above the server maximum (200 by default) is reduced to that maximum. The response returns the applied offset and limit, read the next range until last is true. For trial companies some lists return only the first 50 records, and total is capped accordingly.

0. Authentication

Issue token

Authentication using OAuth 2.0. Get an access token with grant_type=password and get a new one with grant_type=refresh_token when it expires (see expires_in). Pass the access token in the Authorization: Bearer <access_token> header of every API request. A rejected token request returns 401 (wrong credentials, client or grant) or 403 (access denied) with an OAuth 2.0 error body: error, error_description and, when known, type and message

Request

$ curl 'https://solo.cloud/oauth/token' -i -u 'solo-api-client-id:solo-api-secret' -X POST \
    -H 'Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1' \
    -d 'grant_type=password&username=test%2Bapi%40test.com&password=password'

POST /oauth/token HTTP/1.1
Authorization: Basic c29sby1hcGktY2xpZW50LWlkOnNvbG8tYXBpLXNlY3JldA==
Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1
Host: solo.cloud

grant_type=password&username=test%2Bapi%40test.com&password=password

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 9d302163adb9cb7e82860f873b5f4691
X-Solo-Device-Identifier: Jz3R0QV1PNqsQmyTYshJoeJYYspJIrbjdxcDSqTLEnxogq8PIOIM+KHz0fna1+oP21PiiOF08CACJCNbLBqgtg==
Set-Cookie: device-identifier=Jz3R0QV1PNqsQmyTYshJoeJYYspJIrbjdxcDSqTLEnxogq8PIOIM+KHz0fna1+oP21PiiOF08CACJCNbLBqgtg==; Domain=rogii.net; Path=/auth/api/v2; HttpOnly; SameSite=Strict
Set-Cookie: SESSION=YjA5OWQ2MmQtYmUzZS00ZjFkLTliMjQtYzJhZWRmZTk5YmY0; Max-Age=2147483647; Expires=Sun, 24 Oct 2094 11:46:54 GMT; Path=/; HttpOnly; SameSite=Strict
Set-Cookie: SSO-SESSION=YjA5OWQ2MmQtYmUzZS00ZjFkLTliMjQtYzJhZWRmZTk5YmY0; Max-Age=2147483647; Expires=Sun, 24 Oct 2094 11:46:54 GMT; Domain=rogii.com; Path=/; HttpOnly; SameSite=Strict
Set-Cookie: SSO-SESSION=YjA5OWQ2MmQtYmUzZS00ZjFkLTliMjQtYzJhZWRmZTk5YmY0; Max-Age=2147483647; Expires=Sun, 24 Oct 2094 11:46:54 GMT; Domain=solo.cloud; Path=/; HttpOnly; SameSite=Strict
Set-Cookie: SSO-SESSION=YjA5OWQ2MmQtYmUzZS00ZjFkLTliMjQtYzJhZWRmZTk5YmY0; Max-Age=2147483647; Expires=Sun, 24 Oct 2094 11:46:54 GMT; Domain=testsolo.rogii.net; Path=/; HttpOnly; SameSite=Strict
Authorization: b099d62d-be3e-4f1d-9b24-c2aedfe99bf4
Content-Type: application/json;charset=UTF-8

{
  "access_token" : "eyJraWQiOiJjNjMwOGZkMi1iNzY1LTQxZmEtYmNiYi1mYWM3OTJlNjc1MTgiLCJhbGciOiJSUzI1NiJ9.eyJjb21wYW55X2lkIjoyMDAwMywiY2xpZW50X2FwcF9pZCI6InBhcGkiLCJwZXJzb25fdHlwZSI6IlNUQUZGIiwidXNlcl9uYW1lIjoidGVzdCthcGlAdGVzdC5jb20iLCJjbGllbnRfaW5pdF9pcCI6IjEwLjQyLjAuMTcyIiwidXNlcl9kaWdlc3QiOiI4YjllZWEzNzc3IiwiYXV0aG9yaXRpZXMiOlsiUk9MRV9TVEFGRiJdLCJjbGllbnRfaWQiOiJzb2xvLWFwaS1jbGllbnQtaWQiLCJhdWQiOiJzb2xvLXB1YmxpYy1hcGkiLCJ1c2VyX2lkIjoxNDk3LCJzY29wZSI6WyJyZWFkIl0sImV4cCI6MTc5MTI4NTU2NywiaWF0IjoxNzkxMjc1NTY3LCJqdGkiOiJjMTIyYWQ5Zi0yNDA3LTRlNTktYjlkYi02ZTkyNzlkMjY3YTkifQ.loc_gjkM6rCocSof9m4Duy4llxdurbrm8aEpKOI87S13mEJJqMHNmuKZLAF69K_I1A5BbwE0s08qr73jPEsf_Cj8BWeBFQbhShVnhBkX7LbpzcbA_F1ljEYmghfCbwJ0FTsgu4pP-9sCH_HgGf_inbWjdCk7eY8FhfW2yOOp78URo7KJK6Q8yofzawfkRKiurAApeka8hM3M37KByg0a_vYA4_5IVShKvbe0fHtRAh-tlVOT-JSIcx6wTcI3M-01AVTxwYTvrOs7O2Vgo4mArO2vUoIhWGrCPFpGnRAUyVUohTUuD6QHXRIjaDkN37z_S7xxEeKPCm-qujEYteoA4g",
  "refresh_token" : "eyJraWQiOiJjNjMwOGZkMi1iNzY1LTQxZmEtYmNiYi1mYWM3OTJlNjc1MTgiLCJhbGciOiJSUzI1NiJ9.eyJjb21wYW55X2lkIjoyMDAwMywiY2xpZW50X2FwcF9pZCI6InBhcGkiLCJwZXJzb25fdHlwZSI6IlNUQUZGIiwidXNlcl9uYW1lIjoidGVzdCthcGlAdGVzdC5jb20iLCJjbGllbnRfaW5pdF9pcCI6IjEwLjQyLjAuMTcyIiwidXNlcl9kaWdlc3QiOiI4YjllZWEzNzc3IiwiYXV0aG9yaXRpZXMiOlsiUk9MRV9TVEFGRiJdLCJjbGllbnRfaWQiOiJzb2xvLWFwaS1jbGllbnQtaWQiLCJhdWQiOiJzb2xvLXB1YmxpYy1hcGkiLCJ1c2VyX2lkIjoxNDk3LCJzY29wZSI6WyJyZWFkIl0sImV4cCI6MTc5MTMwNTU2NywiaWF0IjoxNzkxMjc1NTY3LCJqdGkiOiI1NjdlNjczNC00NjhlLTQyZTYtODBjZC1iZjdhMDEwNzY3Y2UifQ.IvMBWxaNQvmKnP8hL7sQ62B4fYZwpC4PPCigd_VOhF_q9ueBDj0q5_HpeKFXhiZ8TJh-_FVL4ZtVGnQr-Iz6akz9K2lwxloQwitnbl1e74D7CNa5UwwmLvzGdA0zGaAwVDk4oBKkMJMfxiFnI5b2t8gxaWJQFjFRsBgLRUxDTkeU3WLq8CreqYyROfZtusu27btKYoWot1SNI924Ure9jmgNVz-T1Kmr0FOUKj-e0EjSG7_ufYIZ7DivAOOhDbMcFcVkd6SRyvV_NYZUiFhLtGexGzaSK0Dq314MeynFESeoTg5km7E2aY-vthRrSNSZiHjdYCfIoAdRQk93QYavGQ",
  "scope" : "read",
  "token_type" : "Bearer",
  "expires_in" : 9999,
  "iat" : 1791275567,
  "jti" : "c122ad9f-2407-4e59-b9db-6e9279d267a9"
}

POST /oauth/token

Parameter Description
grant_type The type of grant being presented in exchange for an access and refresh token: password (requires username and password) or refresh_token (requires the refresh_token parameter instead)
username Solo user login
password Solo user password
Header Description
Authorization Authorization header in the following format Basic credentials
credentials is a client_id:secret string encoded in base64 (standard http basic authorization).
client_id is a unique client identifier to access the public api.
secret is a unique client secret string to access the public api.

Response body

Path Type Description
access_token String Access token issued by the authorization server
token_type String Token type
refresh_token String Refresh token associated with the access token. Pass it as the refresh_token parameter with grant_type=refresh_token to get a new access token
expires_in Number Lifetime in seconds of the access token. For example, the value 3600 denotes that the access token will expire in one hour from the time the response was generated
scope String Space-separated scopes of the token
iat Number Time at which the token was issued, in seconds since the Unix epoch
jti String Unique identifier (JWT ID) of the access token

Solo-hosted login for external integrations

In addition to the OAuth 2.0 token methods described above, Solo supports a browser-based, Solo-hosted login flow for external applications. This flow is suitable for integrations that want to present a "Sign in with Solo" button, redirect the user to Solo for authentication, and receive an authorization code that can be exchanged for tokens.

Download sample project

A runnable sample project is available as a reference implementation. It demonstrates the hosted login redirect, callback handling, token exchange, refresh token handling, and local setup with .env.example.

Download: Solo-auth-sample.zip

1. Projects

Create virtual project

Create a virtual project in the global project with the given UUID. User group roles of the global project are copied to the new virtual project. The new virtual project contains no wells, grids, polygons or sticks (the log families of the global project are added automatically), add them with Add virtual project entities. Returns the UUID of the created virtual project

Request

$ curl 'https://solo.cloud/public/api/v1/projects/0638315c-9d00-4663-bddf-029923c52132/virtual' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Virtual project name",
  "description" : "Virtual project description"
}'

POST /public/api/v1/projects/0638315c-9d00-4663-bddf-029923c52132/virtual HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 86

{
  "name" : "Virtual project name",
  "description" : "Virtual project description"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: cf91b2fd4a2ca341caed42468399e320
Content-Type: application/json

{
  "uuid" : "c5561701-a30a-4dd9-a0f0-90521a286846"
}

POST /public/api/v1/projects/{uuid}/virtual

Path parameter Description
uuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Virtual project name, required, up to 200 characters, a request without it or with a blank name is rejected with 400
description String Virtual project description, up to 255 characters

Response body

Path Type Description
uuid String Created virtual project UUID

Add virtual project entities

Add laterals, typewells, grids, polygons and sticks of the parent global project to the virtual project by virtual project UUID. Typewells linked to an added lateral are added too. UUIDs that are not found in the parent project are ignored, objects that are already in the virtual project stay as they are

Request

$ curl 'https://solo.cloud/public/api/v1/projects/virtual/c5561701-a30a-4dd9-a0f0-90521a286846/entities' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "wells" : [ "205fcdd3-da97-4889-9d0e-9d6440671d72", "70d9c2e8-f858-433f-b4f7-f418525e05e4" ],
  "typewells" : [ "23f5d073-c748-47a0-9de1-ce2da1457edc", "3789cc07-19a3-471f-88c3-68a2a6c3d550" ],
  "grids" : [ "9bf34347-922c-46f9-a1a0-252cf1bf935f" ],
  "polygons" : [ "ea077893-7ade-4d78-9f00-686ad2b1b869" ],
  "sticks" : [ "3d79de3d-8f8c-43fa-a32d-41392c42bcab" ]
}'

POST /public/api/v1/projects/virtual/c5561701-a30a-4dd9-a0f0-90521a286846/entities HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 370

{
  "wells" : [ "205fcdd3-da97-4889-9d0e-9d6440671d72", "70d9c2e8-f858-433f-b4f7-f418525e05e4" ],
  "typewells" : [ "23f5d073-c748-47a0-9de1-ce2da1457edc", "3789cc07-19a3-471f-88c3-68a2a6c3d550" ],
  "grids" : [ "9bf34347-922c-46f9-a1a0-252cf1bf935f" ],
  "polygons" : [ "ea077893-7ade-4d78-9f00-686ad2b1b869" ],
  "sticks" : [ "3d79de3d-8f8c-43fa-a32d-41392c42bcab" ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ba243b0ad2d37e810e37b83941e421b2

POST /public/api/v1/projects/virtual/{uuid}/entities

Path parameter Description
uuid Virtual project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
wells Array Optional list of lateral UUIDs to add to the virtual project. Typewells linked to these laterals are added too
typewells Array Optional list of typewell UUIDs to add to the virtual project
grids Array Optional list of grid UUIDs to add to the virtual project
polygons Array Optional list of polygon UUIDs to add to the virtual project
sticks Array Optional list of stick UUIDs to add to the virtual project

Response body

Empty body

Get projects

Get a list of global projects of the company that the current user has access to with pagination, sorted by name. Virtual projects are returned by Get virtual projects. Available to company users only, support and machine accounts get 403

Request

$ curl 'https://solo.cloud/public/api/v1/projects?filter=pApi&offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/projects?filter=pApi&offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: c5c3c95f99f1fe3a9e1a9f0a840ea4c2
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "47f74a14-2148-4193-9052-a0fa4536988e",
    "name" : "Papi test project 1",
    "measure_unit" : "FOOT",
    "role" : "MANAGER",
    "accessed_on" : "2026-10-06T08:32:43Z",
    "modified_on" : "2026-10-06T08:32:43Z"
  }, {
    "uuid" : "0d73a04b-3df0-459b-b72d-bca72f923fca",
    "name" : "Papi test project 2",
    "measure_unit" : "METER",
    "role" : "MANAGER",
    "geo_crs" : {
      "code" : 2000,
      "authority" : "EPSG",
      "name" : "Anguilla 1957 / British West Indies Grid",
      "measure_unit" : "METER"
    },
    "accessed_on" : "2026-10-06T08:32:43Z",
    "modified_on" : "2026-10-06T08:32:43Z"
  }, {
    "uuid" : "0638315c-9d00-4663-bddf-029923c52132",
    "name" : "Papi test project 3",
    "measure_unit" : "FOOT",
    "role" : "MANAGER",
    "geo_crs" : {
      "code" : 2270,
      "authority" : "EPSG",
      "name" : "NAD83 / Oregon South (ft)",
      "measure_unit" : "FOOT"
    },
    "accessed_on" : "2026-10-06T08:32:44Z",
    "modified_on" : "2026-10-06T08:32:44Z"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 3,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects

Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the projects whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Project UUID
content[].name String Project name
content[].measure_unit String Project measure unit: METER, FOOT or METER_FOOT (depths in feet, horizontal coordinates and distances in meters)
content[].role String Role of the current user in the project, for example VIEWER, INTERPRETER, POWER_INTERPRETER, DATA_MANAGER or MANAGER
content[].accessed_on String Date/time project last accessed at
content[].modified_on String Date/time project last modified at
content[].geo_crs Object Project coordinate reference system (CRS), absent if the project has no CRS
content[].geo_crs.code Varies CRS code
content[].geo_crs.authority Varies CRS authority
content[].geo_crs.name Varies CRS name
content[].geo_crs.measure_unit Varies CRS length unit: METER, MILLIMETER, FOOT, FOOT_US or INCH_US

Get virtual projects

Get a list of company virtual projects that the current user has access to with pagination, sorted by name. Virtual projects use a subset of data from a Global Project and have their own access roles defined in the SOLO Admin Panel. They can be easily managed for specific users and any changes made are updated across the database. Data added to a Virtual Project is also added to the corresponding Global Project. Available to company users only, support and machine accounts get 403

Request

$ curl 'https://solo.cloud/public/api/v1/projects/virtual?filter=pApi&offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/projects/virtual?filter=pApi&offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 66a06f14233a7d7c88d22d48a19dd158
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "550f1232-05de-4e8c-8264-71492d1a21a7",
    "name" : "Virtual Papi test project 1",
    "measure_unit" : "FOOT",
    "role" : "MANAGER",
    "parent_uuid" : "47f74a14-2148-4193-9052-a0fa4536988e",
    "parent_name" : "Papi test project 1",
    "virtual" : true,
    "modified_on" : "2026-10-06T08:32:43Z"
  }, {
    "uuid" : "ffdee89c-3513-406f-b362-ae355b50efcf",
    "name" : "Virtual Papi test project 2",
    "measure_unit" : "METER",
    "role" : "MANAGER",
    "geo_crs" : {
      "code" : 2000,
      "authority" : "EPSG",
      "name" : "Anguilla 1957 / British West Indies Grid",
      "measure_unit" : "METER"
    },
    "parent_uuid" : "0d73a04b-3df0-459b-b72d-bca72f923fca",
    "parent_name" : "Papi test project 2",
    "virtual" : true,
    "modified_on" : "2026-10-06T08:32:43Z"
  }, {
    "uuid" : "0a6f8005-7c60-459c-9f91-6a1ef64d9098",
    "name" : "Virtual Papi test project 3",
    "measure_unit" : "FOOT",
    "role" : "MANAGER",
    "geo_crs" : {
      "code" : 2270,
      "authority" : "EPSG",
      "name" : "NAD83 / Oregon South (ft)",
      "measure_unit" : "FOOT"
    },
    "parent_uuid" : "0638315c-9d00-4663-bddf-029923c52132",
    "parent_name" : "Papi test project 3",
    "virtual" : true,
    "modified_on" : "2026-10-06T08:32:44Z"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 3,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/virtual

Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the virtual projects whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Virtual project UUID
content[].name String Virtual project name
content[].measure_unit String Measure unit of the parent project: METER, FOOT or METER_FOOT (depths in feet, horizontal coordinates and distances in meters)
content[].role String Role of the current user in the virtual project, for example VIEWER, INTERPRETER, POWER_INTERPRETER, DATA_MANAGER or MANAGER
content[].accessed_on String Date/time the virtual project was last accessed at
content[].modified_on String Date/time the parent project was last modified at
content[].geo_crs Object Coordinate reference system (CRS) of the parent project, absent if the project has no CRS
content[].parent_uuid String UUID of the global project the virtual project belongs to
content[].parent_name String Name of the global project the virtual project belongs to
content[].virtual Boolean Always true for a virtual project
content[].geo_crs.code Varies CRS code
content[].geo_crs.authority Varies CRS authority
content[].geo_crs.name Varies CRS name
content[].geo_crs.measure_unit Varies CRS length unit: METER, MILLIMETER, FOOT, FOOT_US or INCH_US

Get project

Get a global or virtual project by UUID. For a virtual project the response also has the parent_uuid, parent_name and virtual fields described in Get virtual projects. Returns 403 if the project does not exist or is not accessible

Request

$ curl 'https://solo.cloud/public/api/v1/projects/0638315c-9d00-4663-bddf-029923c52132' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/projects/0638315c-9d00-4663-bddf-029923c52132 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f8b9c3f8ff4bbdab5f1eb40dc064c251
Content-Type: application/json

{
  "uuid" : "0638315c-9d00-4663-bddf-029923c52132",
  "name" : "Papi test project 3",
  "measure_unit" : "FOOT",
  "role" : "MANAGER",
  "geo_crs" : {
    "code" : 2270,
    "authority" : "EPSG",
    "name" : "NAD83 / Oregon South (ft)",
    "measure_unit" : "FOOT"
  },
  "accessed_on" : "2026-10-06T08:32:44Z",
  "modified_on" : "2026-10-06T08:32:44Z"
}

GET /public/api/v1/projects/{uuid}

Path parameter Description
uuid Project UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
uuid String Project UUID
name String Project name
measure_unit String Project measure unit: METER, FOOT or METER_FOOT (depths in feet, horizontal coordinates and distances in meters)
role String Role of the current user in the project, for example VIEWER, INTERPRETER, POWER_INTERPRETER, DATA_MANAGER or MANAGER
accessed_on String Date/time project last accessed at
modified_on String Date/time project last modified at
geo_crs Object Project coordinate reference system (CRS), absent if the project has no CRS
geo_crs.code Number CRS code
geo_crs.authority String CRS authority
geo_crs.name String CRS name
geo_crs.measure_unit String CRS length unit: METER, MILLIMETER, FOOT, FOOT_US or INCH_US

Get recently updated objects

Get laterals (WELL) and typewells (TYPEWELL) of a global or virtual project that were created, updated or deleted after modified_since. Other object types are not reported, and a well that was created and deleted within the interval is not reported at all. For a virtual project, adding a well to it is reported as CREATE and removing it as DELETE. If modified_since is not earlier than the last project modification, content is empty. Pass the returned modified_on as modified_since in the next request

Request

$ curl 'https://solo.cloud/public/api/v1/projects/0638315c-9d00-4663-bddf-029923c52132/changes' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "modified_since" : "2026-10-06T08:31:44.057Z"
}'

POST /public/api/v1/projects/0638315c-9d00-4663-bddf-029923c52132/changes HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 51

{
  "modified_since" : "2026-10-06T08:31:44.057Z"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 24fae769476a1a560de92fcc6700bd68
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "205fcdd3-da97-4889-9d0e-9d6440671d72",
    "type" : "WELL",
    "operation" : "CREATE"
  }, {
    "uuid" : "23f5d073-c748-47a0-9de1-ce2da1457edc",
    "type" : "TYPEWELL",
    "operation" : "CREATE"
  } ],
  "modified_on" : "2026-10-06T08:32:44.485Z",
  "modified_at" : "2026-10-06T08:32:44.485+00:00"
}

POST /public/api/v1/projects/{uuid}/changes

Path parameter Description
uuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
modified_since String Return changes made after this date/time, ISO 8601, for example 2026-03-12T12:00:00.000Z

Response body

Path Type Description
content Array Content array
modified_on String Date/time the project was last modified at, with milliseconds. Pass it as modified_since in the next request to get only newer changes
modified_at String Deprecated, the same date/time as modified_on
content[].uuid String Lateral or typewell UUID
content[].type String Object type: WELL (lateral) or TYPEWELL
content[].operation String Change of the object since modified_since: CREATE, UPDATE or DELETE

Get project history

Get the change history of a global or virtual project with pagination, one item per revision, oldest first. All request body filters are optional and are combined, modified_since and modified_to are inclusive. Revisions made by service users are not returned

Request

$ curl 'https://solo.cloud/public/api/v1/projects/8703082f-d258-444e-896f-fe1a16b770e4/history?offset=0&limit=4' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "modified_since" : "2026-03-12T12:00:00.000+00:00",
  "modified_to" : "2026-03-12T13:00:00.000+00:00",
  "user_name" : "Bot Manager",
  "user_email" : "a.bortnikov+manager@rogii.com",
  "well_name" : "Typewell",
  "well_ids" : [ "755135f6-6634-49bb-ad1f-093bf4efcc9c" ],
  "sources" : [ "ANY" ]
}'

POST /public/api/v1/projects/8703082f-d258-444e-896f-fe1a16b770e4/history?offset=0&limit=4 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 300

{
  "modified_since" : "2026-03-12T12:00:00.000+00:00",
  "modified_to" : "2026-03-12T13:00:00.000+00:00",
  "user_name" : "Bot Manager",
  "user_email" : "a.bortnikov+manager@rogii.com",
  "well_name" : "Typewell",
  "well_ids" : [ "755135f6-6634-49bb-ad1f-093bf4efcc9c" ],
  "sources" : [ "ANY" ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 7403cb7037470b35
Content-Type: application/json

{
  "content" : [ {
    "modified_at" : "2026-03-12T12:00:04.441+00:00",
    "user_email" : "a.bortnikov+manager@rogii.com",
    "user_name" : "Bot Manager",
    "source" : "portal",
    "well_id" : "755135f6-6634-49bb-ad1f-093bf4efcc9c",
    "well_name" : "Typewell",
    "well_type" : "TYPEWELL",
    "changes" : [ {
      "operation" : "CREATE",
      "object_id" : "755135f6-6634-49bb-ad1f-093bf4efcc9c",
      "object_type" : "TYPEWELL",
      "object_name" : "Typewell"
    }, {
      "operation" : "CREATE",
      "object_id" : "00000000-0000-0000-0000-000000000001",
      "object_type" : "WELLHEADER",
      "object_name" : "Name"
    }, {
      "operation" : "CREATE",
      "object_id" : "00000000-0000-0000-0000-000000000002",
      "object_type" : "WELLHEADER",
      "object_name" : "API"
    }, {
      "operation" : "CREATE",
      "object_id" : "00000000-0000-0000-0000-000000000004",
      "object_type" : "WELLHEADER",
      "object_name" : "Operator"
    }, {
      "operation" : "CREATE",
      "object_id" : "00000000-0000-0000-0000-000000000007",
      "object_type" : "WELLHEADER",
      "object_name" : "KB"
    }, {
      "operation" : "CREATE",
      "object_id" : "00000000-0000-0000-0000-000000000008",
      "object_type" : "WELLHEADER",
      "object_name" : "Azimuth VS"
    }, {
      "operation" : "CREATE",
      "object_id" : "00000000-0000-0000-0000-000000000009",
      "object_type" : "WELLHEADER",
      "object_name" : "Convergence"
    }, {
      "operation" : "CREATE",
      "object_id" : "00000000-0000-0000-0000-000000000012",
      "object_type" : "WELLHEADER",
      "object_name" : "X-srf"
    }, {
      "operation" : "CREATE",
      "object_id" : "00000000-0000-0000-0000-000000000013",
      "object_type" : "WELLHEADER",
      "object_name" : "Y-srf"
    } ]
  }, {
    "modified_at" : "2026-03-12T12:00:05.488+00:00",
    "user_email" : "a.bortnikov+manager@rogii.com",
    "user_name" : "Bot Manager",
    "source" : "portal",
    "well_id" : "755135f6-6634-49bb-ad1f-093bf4efcc9c",
    "well_name" : "Typewell",
    "well_type" : "TYPEWELL",
    "changes" : [ {
      "operation" : "CREATE",
      "object_id" : "489bce1c-333d-486d-b84d-89670505f9f3",
      "object_type" : "LOG",
      "object_name" : "Log"
    } ]
  }, {
    "modified_at" : "2026-03-12T12:00:05.634+00:00",
    "user_email" : "a.bortnikov+manager@rogii.com",
    "user_name" : "Bot Manager",
    "source" : "portal",
    "well_id" : "755135f6-6634-49bb-ad1f-093bf4efcc9c",
    "well_name" : "Typewell",
    "well_type" : "TYPEWELL",
    "changes" : [ {
      "operation" : "CREATE",
      "object_id" : "3bd00b21-c7d9-407e-83e9-347d50cef95d",
      "object_type" : "TOPSET",
      "object_name" : "Top Set"
    } ]
  }, {
    "modified_at" : "2026-03-12T12:00:05.982+00:00",
    "user_email" : "a.bortnikov+manager@rogii.com",
    "user_name" : "Bot Manager",
    "source" : "portal",
    "well_id" : "755135f6-6634-49bb-ad1f-093bf4efcc9c",
    "well_name" : "Typewell",
    "well_type" : "TYPEWELL",
    "changes" : [ {
      "operation" : "CREATE",
      "object_id" : "1b97e61f-f57e-4fa4-8df1-21ee3a1b0244",
      "object_type" : "MUDLOG",
      "object_name" : "Mud Log"
    } ]
  } ],
  "offset" : 0,
  "limit" : 4,
  "total" : 32,
  "last" : false,
  "first" : true
}

POST /public/api/v1/projects/{uuid}/history

Path parameter Description
uuid Project UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header
Body field Type Description
modified_since String Return revisions made at or after this date/time, ISO 8601 with a time zone offset
modified_to String Return revisions made at or before this date/time, ISO 8601 with a time zone offset
user_name String Filter by the name of the user who made the changes (full-text match)
user_email String Filter by the email of the user who made the changes (full-text match)
well_name String Filter by lateral or typewell name (full-text match)
well_ids Array Filter by lateral or typewell UUIDs
object_name String Filter by the name of a changed object (full-text match)
object_ids Array Filter by UUIDs of changed objects
sources Array Filter by client applications that made the changes. ANY or an empty list disables the filter. Allowed values: ACTIVITY_LOG, ALERTS, ANY, DATA_MANAGER, DRILLSPOT, DRILLSPOT_FEED, DRILLSPOT_SOLO_FEED, FEED_OUTPUT, FEED_SAAS_OUTPUT, FEED_WELLVIEW, LANDING, PAPI, PETREL, PYTHON_SDK, SAAS_STARSTEER, SOLOBOX, SOLO_CONNECT, SOLO_CONNECT_CLOUD, SOLO_FEED, STARFRAC, STARSTEER, SYSTEM_ROBOT, TLOG, WEB_ADMIN, WEB_FREE_VIEWER_NATIVE_ANDROID, WEB_FREE_VIEWER_NATIVE_IOS, WEB_PORTAL, WEB_SUPPORT_MANAGEMENT, WEB_VIEWER, WEB_VIEWER_MOBILE, WEB_VIEWER_NATIVE_ANDROID, WEB_VIEWER_NATIVE_IOS, WITSML, WITSML_SERVER, WS_RTM, WS_RTM_NATIVE_ANDROID, WS_RTM_NATIVE_IOS

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].modified_at String Date/time of the revision
content[].user_email String User email
content[].user_name String User name
content[].source String Identifier of the client application that made the changes, for example portal for WEB_PORTAL or papi for PAPI
content[].well_id String UUID of the lateral or typewell changed in the revision, absent if no well was changed
content[].well_name String Name of the lateral or typewell changed in the revision
content[].well_type String Type of the changed well: WELL (lateral) or TYPEWELL
content[].changes Array Objects changed in the revision
content[].changes[].operation String Operation performed on the object, for example CREATE, UPDATE, DELETE, LOCKED or UNLOCKED
content[].changes[].object_id String Object UUID
content[].changes[].object_type String Type of the changed object, for example WELL, TYPEWELL or LOG
content[].changes[].object_name String Object name

Delete virtual project

Delete virtual project by virtual project UUID. Only the virtual project is deleted, the objects of the global project are not affected

Request

$ curl 'https://solo.cloud/public/api/v1/projects/virtual/c5561701-a30a-4dd9-a0f0-90521a286846' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/projects/virtual/c5561701-a30a-4dd9-a0f0-90521a286846 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 961288846d26c5fb12f25947f8fc0a23

DELETE /public/api/v1/projects/virtual/{uuid}

Path parameter Description
uuid Virtual project UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

2. Laterals

Create lateral

Create lateral by project UUID

Request

$ curl 'https://solo.cloud/public/api/v1/projects/1e6eedac-1d59-4f16-9738-0ff9e455135a/wells' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Lateral name",
  "operator" : "operator",
  "api" : "api",
  "convergence" : {
    "val" : 90.0
  },
  "azimuth" : {
    "val" : 45.0
  },
  "kb" : {
    "val" : 0.3
  },
  "tieintvd" : {
    "val" : 0.4
  },
  "tieinns" : {
    "val" : 0.5
  },
  "tieinew" : {
    "val" : 0.6
  },
  "xsrfreal" : {
    "val" : 100.0
  },
  "ysrfreal" : {
    "val" : 500.0
  }
}'

POST /public/api/v1/projects/1e6eedac-1d59-4f16-9738-0ff9e455135a/wells HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 377

{
  "name" : "Lateral name",
  "operator" : "operator",
  "api" : "api",
  "convergence" : {
    "val" : 90.0
  },
  "azimuth" : {
    "val" : 45.0
  },
  "kb" : {
    "val" : 0.3
  },
  "tieintvd" : {
    "val" : 0.4
  },
  "tieinns" : {
    "val" : 0.5
  },
  "tieinew" : {
    "val" : 0.6
  },
  "xsrfreal" : {
    "val" : 100.0
  },
  "ysrfreal" : {
    "val" : 500.0
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: b4ec397e28494ad68ed5c224c27665ba
Content-Type: application/json

{
  "uuid" : "51210ddb-5898-4d63-a275-378ae4cd6154"
}

POST /public/api/v1/projects/{uuid}/wells

Path parameter Description
uuid Project UUID (a virtual project UUID is also accepted)
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Lateral name
operator String Operator name
api String API lateral number
convergence.val Number Grid convergence angle in degrees
azimuth.val Number Vertical section azimuth in degrees
kb.val Number Kelly bushing (KB) elevation above MSL in project units
tieintvd.val Number Tie-in point TVD in project units
tieinns.val Number Tie-in point NS in project units
tieinew.val Number Tie-in point EW in project units
xsrfreal.val Number X surface coordinate in project units
ysrfreal.val Number Y surface coordinate in project units

Response body

Path Type Description
uuid String Created lateral UUID

Get laterals by project

Get a list of laterals by project UUID with pagination, sorted by name. A virtual project UUID is also accepted, then only the laterals added to that virtual project are listed

Request

$ curl 'https://solo.cloud/public/api/v1/projects/1e6eedac-1d59-4f16-9738-0ff9e455135a/wells?offset=0&limit=10&filter=oNe' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/1e6eedac-1d59-4f16-9738-0ff9e455135a/wells?offset=0&limit=10&filter=oNe HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3b400ec0a963fa935ca56bca9fc8a144
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "963b7f11-f3d7-485c-8f6d-0f25a50b080f",
    "name" : "Lateral one",
    "api" : "api lateral one",
    "flags" : {
      "has_logs" : false,
      "has_topsets" : false,
      "has_interpretations" : false,
      "has_nested_wells" : false,
      "has_mudlogs" : false,
      "has_target_lines" : false
    }
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{uuid}/wells

Path parameter Description
uuid Project UUID (a virtual project UUID is also accepted)
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the laterals whose name or API contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Lateral UUID
content[].name String Lateral name
content[].api String API lateral number
content[].flags.has_logs Boolean true if the lateral has at least one log with data
content[].flags.has_topsets Boolean true if the lateral has at least one topset
content[].flags.has_interpretations Boolean true if the lateral has at least one interpretation that is neither private nor a service (AUTO) one
content[].flags.has_nested_wells Boolean true if the lateral has at least one nested well
content[].flags.has_mudlogs Boolean true if the lateral has at least one mudlog with data
content[].flags.has_target_lines Boolean true if the lateral has at least one target line

Get laterals by API filter

Search laterals by API number with pagination: returns the laterals whose api contains filter (case insensitive) from all company projects where the caller has a role other than NO_ACCESS, directly or through a virtual project, in lateral creation order. Available to company users only, support and machine accounts get 403

Request

$ curl 'https://solo.cloud/public/api/v1/wells/api-filtered?offset=0&limit=10&filter=lateral%20t' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/api-filtered?offset=0&limit=10&filter=lateral%20t HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 1bd55b6c022bdf2e8e740682cda3fbcc
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "a1dcb1e7-e47b-403b-a074-8fab56558e4a",
    "name" : "Lateral two",
    "api" : "api lateral two",
    "flags" : {
      "has_logs" : false,
      "has_topsets" : false,
      "has_interpretations" : false,
      "has_nested_wells" : false,
      "has_mudlogs" : false,
      "has_target_lines" : false
    },
    "project_uuid" : "1e6eedac-1d59-4f16-9738-0ff9e455135a",
    "project_role" : "MANAGER"
  }, {
    "uuid" : "8fb10db3-6ca4-493f-b7b8-eb82c2c6ee23",
    "name" : "Lateral three",
    "api" : "api lateral three",
    "flags" : {
      "has_logs" : false,
      "has_topsets" : false,
      "has_interpretations" : false,
      "has_nested_wells" : false,
      "has_mudlogs" : false,
      "has_target_lines" : false
    },
    "project_uuid" : "1e6eedac-1d59-4f16-9738-0ff9e455135a",
    "project_role" : "MANAGER"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/api-filtered

Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Required. Returns only the laterals whose API contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Lateral UUID
content[].name String Lateral name
content[].api String API lateral number
content[].flags.has_logs Boolean true if the lateral has at least one log with data
content[].flags.has_topsets Boolean true if the lateral has at least one topset
content[].flags.has_interpretations Boolean true if the lateral has at least one interpretation that is neither private nor a service (AUTO) one
content[].flags.has_nested_wells Boolean true if the lateral has at least one nested well
content[].flags.has_mudlogs Boolean true if the lateral has at least one mudlog with data
content[].flags.has_target_lines Boolean true if the lateral has at least one target line
content[].project_uuid String UUID of the project the lateral belongs to, or of the virtual project when the caller has access to the lateral only through it
content[].project_role String Role of the caller in the project (or virtual project) given by project_uuid

Get lateral metadata

Get lateral metadata

Request

$ curl 'https://solo.cloud/public/api/v1/wells/8fb10db3-6ca4-493f-b7b8-eb82c2c6ee23' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/8fb10db3-6ca4-493f-b7b8-eb82c2c6ee23 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 83f3bee6fe609521e60d05c87c6f46e9
Content-Type: application/json

{
  "uuid" : "8fb10db3-6ca4-493f-b7b8-eb82c2c6ee23",
  "name" : "Lateral three",
  "operator" : "string",
  "api" : "api lateral three",
  "xsrf" : {
    "val" : 19.68503937007874
  },
  "ysrf" : {
    "val" : 32.808398950131235
  },
  "kb" : {
    "val" : 22.96587926509186
  },
  "convergence" : {
    "val" : 0.0
  },
  "azimuth" : {
    "val" : 0.0
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 3.280839895013123
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}

GET /public/api/v1/wells/{uuid}

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
uuid String Lateral UUID
name String Lateral name
operator String Operator name
api String API lateral number
xsrf.val Number X surface coordinate in project units
ysrf.val Number Y surface coordinate in project units
kb.val Number Kelly bushing (KB) elevation above MSL in project units
azimuth.val Number Vertical section azimuth in degrees
convergence.val Number Grid convergence angle in degrees
tie_in_tvd.val Number Tie-in point TVD in project units
tie_in_ns.val Number Tie-in point NS in project units
tie_in_ew.val Number Tie-in point EW in project units
last_feed_stream_date String Timestamp of last update by Solo Feed

Get lateral ellipses

Get lateral ellipses data by lateral UUID. Returns 404 if no ellipses are stored for the lateral

Request

$ curl 'https://solo.cloud/public/api/v1/laterals/3f21c157-40cb-4d75-974f-f186b16e26bf/ellipses' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/laterals/3f21c157-40cb-4d75-974f-f186b16e26bf/ellipses HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: d4d2ebb85ee45b0b0a80c4ac087bb518
Content-Type: application/json

{
  "content" : [ {
    "index" : 10.0,
    "value" : {
      "nev" : [ 14.99, 98.23, 41.2, 67.78, 23.89, 12.31, 55.43, 11.23, 34.33 ],
      "messages" : [ ]
    }
  } ]
}

GET /public/api/v1/laterals/{lateralUuid}/ellipses

Path parameter Description
lateralUuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Ellipses points array sorted by index ascending
content[].index Number Measured Depth value of the point
content[].value.nev Array Ellipse attributes
content[].value.messages Array Comments

Get starred objects

Get starred objects by lateral UUID. A field is omitted when nothing of that type is starred or the starred object no longer exists

Request

$ curl 'https://solo.cloud/public/api/v1/wells/24b83127-3c33-4b40-a5d0-4d15994ae814/starred' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/wells/24b83127-3c33-4b40-a5d0-4d15994ae814/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: b6301e7ee4d676c36f0e8aed86ed9a6f
Content-Type: application/json

{
  "target_line" : "93bc4c47-db0f-4118-8f8a-bb8be68e05d6",
  "nested_well" : "bc25afc7-b7f7-4600-ab56-a2a6f49c2d7a",
  "interpretation" : "68012356-f06f-4cb3-9b08-edebe6f63b93",
  "topset" : "91485dd1-50b7-4eed-870d-6dba93337cc1"
}

GET /public/api/v1/wells/{uuid}/starred

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
target_line String Starred target line UUID, absent if none is starred
nested_well String Starred nested well UUID, absent if none is starred
interpretation String Starred interpretation UUID, absent if none is starred
topset String Starred topset UUID, absent if none is starred

Get linked typewells

Get a list of typewells linked to the lateral with pagination, in link creation order. Inactive links are not listed

Request

$ curl 'https://solo.cloud/public/api/v1/wells/3f7ec470-55a9-4d12-899b-8fd44af0306a/linked?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/wells/3f7ec470-55a9-4d12-899b-8fd44af0306a/linked?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: efd45d8f87fd0a7d2d06c6292ad2ddfb
Content-Type: application/json

{
  "content" : [ {
    "shift" : {
      "val" : 1640.4199475065616
    },
    "typewell_id" : "daa63af1-5fbf-4415-8579-146d30b81fcf"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/linked

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].shift.val Number Typewell shift in project units
content[].typewell_id String Typewell UUID

Get bit projection

Get bit projection by lateral UUID. Returns 406 if the lateral has no bit projection

Request

$ curl 'https://solo.cloud/public/api/v1/wells/a220bcab-6764-47a9-b96f-03128c546941/bitprojection' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/wells/a220bcab-6764-47a9-b96f-03128c546941/bitprojection HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: d55b2c5788fedf6935653b3687063e81
Content-Type: application/json

{
  "mode" : "CALCULATED",
  "sub_mode" : "DLS_TF",
  "distance_to_bit" : {
    "val" : 30.0
  },
  "dls" : {
    "val" : 9.499999999999998
  },
  "tool_face" : {
    "val" : 120.49999999999999
  },
  "continuous_inclination_log" : "00000000-0000-0000-0000-000000000000",
  "last_log_point_log" : "00000000-0000-0000-0000-000000000000"
}

GET /public/api/v1/wells/{uuid}/bitprojection

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
mode String Can be [OFF, CALCULATED, PREDEFINED, DRILLSPOT_MULTIPOINT], the last one cannot be set via this API
sub_mode String Can be [TREND, DLS_TF, CONT_INCL_LOG]
distance_to_bit.val Number Distance to bit in meters, not converted to project units, range [0; 100000]
dls.val Number Dogleg Severity value in degrees per 30 m for meter projects or per 100 ft for other projects (range [0; 60])
tool_face.val Number Tool face value in degrees (range [-180; 180])
continuous_inclination_log String Continuous inclination log UUID (00000000-0000-0000-0000-000000000000 if no log is selected)
last_log_point_log String UUID of the log the projection is based on (00000000-0000-0000-0000-000000000000 for the last survey)

Update lateral metadata

Update lateral metadata by UUID. name is required. Values are in project units, angles in degrees. Returns 403 if the lateral is locked or is a private lateral of another user

Request

$ curl 'https://solo.cloud/public/api/v1/wells/963b7f11-f3d7-485c-8f6d-0f25a50b080f' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Lateral name",
  "api" : "api lateral",
  "operator" : "string",
  "xsrf" : {
    "val" : 60.5
  },
  "ysrf" : {
    "val" : 100.0
  },
  "kb" : {
    "val" : 70.0
  },
  "azimuth" : {
    "val" : 0.0
  },
  "convergence" : {
    "val" : 0.0
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 1.0
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}'

PATCH /public/api/v1/wells/963b7f11-f3d7-485c-8f6d-0f25a50b080f HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 379

{
  "name" : "Lateral name",
  "api" : "api lateral",
  "operator" : "string",
  "xsrf" : {
    "val" : 60.5
  },
  "ysrf" : {
    "val" : 100.0
  },
  "kb" : {
    "val" : 70.0
  },
  "azimuth" : {
    "val" : 0.0
  },
  "convergence" : {
    "val" : 0.0
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 1.0
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3510fb5f8f7453db256cd709b635ea77

PATCH /public/api/v1/wells/{uuid}

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Lateral name, required and not blank (at most 200 characters)
operator String Operator name (at most 200 characters)
api String API lateral number (at most 200 characters)
xsrf.val Number X surface coordinate in project units
ysrf.val Number Y surface coordinate in project units
kb.val Number Kelly bushing (KB) elevation above MSL in project units
azimuth.val Number Vertical section azimuth in degrees
convergence.val Number Grid convergence angle in degrees
tie_in_tvd.val Number Tie-in point TVD in project units
tie_in_ns.val Number Tie-in point NS in project units
tie_in_ew.val Number Tie-in point EW in project units

Response body

Empty body

Set starred objects

Set starred objects by lateral UUID. Omitted fields keep their current value, 00000000-0000-0000-0000-000000000000 resets a field. Every other UUID must belong to an object of this lateral, otherwise 406 is returned. A private lateral of another user is rejected with 403

Request

$ curl 'https://solo.cloud/public/api/v1/wells/24b83127-3c33-4b40-a5d0-4d15994ae814/starred' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "targetline" : "93bc4c47-db0f-4118-8f8a-bb8be68e05d6",
  "nestedwell" : "bc25afc7-b7f7-4600-ab56-a2a6f49c2d7a",
  "interpretation" : "68012356-f06f-4cb3-9b08-edebe6f63b93",
  "topset" : "91485dd1-50b7-4eed-870d-6dba93337cc1"
}'

PUT /public/api/v1/wells/24b83127-3c33-4b40-a5d0-4d15994ae814/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 230

{
  "targetline" : "93bc4c47-db0f-4118-8f8a-bb8be68e05d6",
  "nestedwell" : "bc25afc7-b7f7-4600-ab56-a2a6f49c2d7a",
  "interpretation" : "68012356-f06f-4cb3-9b08-edebe6f63b93",
  "topset" : "91485dd1-50b7-4eed-870d-6dba93337cc1"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 821c79ed0ef85b7b01edc6d7c9b21788

PUT /public/api/v1/wells/{uuid}/starred

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
targetline String UUID of a target line of this lateral to set starred (use "00000000-0000-0000-0000-000000000000" to reset, omit to keep the current one)
nestedwell String UUID of a nested well of this lateral to set starred (use "00000000-0000-0000-0000-000000000000" to reset, omit to keep the current one)
interpretation String UUID of an interpretation of this lateral to set starred (use "00000000-0000-0000-0000-000000000000" to reset, omit to keep the current one)
topset String UUID of a topset of this lateral to set starred (use "00000000-0000-0000-0000-000000000000" to reset, omit to keep the current one)

Response body

Empty body

Set bit projection

Set bit projection by lateral UUID. mode is required, a request without it is rejected with 400. For OFF and PREDEFINED modes send mode only. CALCULATED mode requires sub_mode and distance_to_bit plus the fields of the sub-mode: last_log_point_log for TREND, last_log_point_log, dls and tool_face for DLS_TF, continuous_inclination_log for CONT_INCL_LOG. Fields of other sub-modes must not be sent, a log UUID must be a log of this lateral. Parameters that are not sent keep their stored values. Requests that break these rules are rejected with 406

Request

$ curl 'https://solo.cloud/public/api/v1/wells/9d133a68-2aec-43c9-a92f-4387d1dc0986/bitprojection' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "mode" : "CALCULATED",
  "sub_mode" : "DLS_TF",
  "distance_to_bit" : {
    "val" : 30.0
  },
  "dls" : {
    "val" : 9.5
  },
  "tool_face" : {
    "val" : 120.5
  },
  "last_log_point_log" : "00000000-0000-0000-0000-000000000000"
}'

PUT /public/api/v1/wells/9d133a68-2aec-43c9-a92f-4387d1dc0986/bitprojection HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 237

{
  "mode" : "CALCULATED",
  "sub_mode" : "DLS_TF",
  "distance_to_bit" : {
    "val" : 30.0
  },
  "dls" : {
    "val" : 9.5
  },
  "tool_face" : {
    "val" : 120.5
  },
  "last_log_point_log" : "00000000-0000-0000-0000-000000000000"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 4f3655bece21186cc5a526fae7ed5830

PUT /public/api/v1/wells/{uuid}/bitprojection

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
mode String Can be [OFF, CALCULATED, PREDEFINED]. For OFF and PREDEFINED no other field is allowed
sub_mode String Can be [TREND, DLS_TF, CONT_INCL_LOG], required for CALCULATED mode
distance_to_bit.val Number Distance to bit in meters, not converted to project units, range [0; 100000], required for CALCULATED mode
dls.val Number Dogleg Severity value in degrees per 30 m for meter projects or per 100 ft for other projects (range [0; 60]), required for DLS_TF sub-mode and not allowed for other sub-modes
tool_face.val Number Tool face value in degrees (range [-180; 180]), required for DLS_TF sub-mode and not allowed for other sub-modes
continuous_inclination_log String UUID of a log of this lateral or 00000000-0000-0000-0000-000000000000 for no log, required for CONT_INCL_LOG sub-mode and not allowed for other sub-modes
last_log_point_log String UUID of a log of this lateral or 00000000-0000-0000-0000-000000000000 for the last survey, required for TREND and DLS_TF sub-modes and not allowed for CONT_INCL_LOG

Response body

Empty body

Link a typewell to the lateral by lateral UUID, or update the shift of an existing link. shift is in project depth units, an omitted shift is stored as undefined. A deactivated link is activated again. typewell_id is required, a request without it or with a typewell of another project is rejected with 400. Returns 404 if the typewell does not exist and 409 if the link cannot be saved, for example because of a concurrent change. Linked typewells are returned by Get linked typewells. Requires the permission to create well references in the project

Request

$ curl 'https://solo.cloud/public/api/v1/wells/963b7f11-f3d7-485c-8f6d-0f25a50b080f/linked' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "typewell_id" : "51be8f09-da53-4f18-8439-a2c4e2016ae2",
  "shift" : {
    "val" : 500.0
  }
}'

POST /public/api/v1/wells/963b7f11-f3d7-485c-8f6d-0f25a50b080f/linked HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 97

{
  "typewell_id" : "51be8f09-da53-4f18-8439-a2c4e2016ae2",
  "shift" : {
    "val" : 500.0
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: a09df4ca103e4b26cca771e7c8470b45

POST /public/api/v1/wells/{uuid}/linked

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
typewell_id String UUID of the typewell to link to the lateral
shift Object Typewell shift. If present val is set, otherwise undefined is true. An omitted shift is stored as undefined
shift.val Number Typewell shift value in project units
shift.undefined Boolean Set to true if the shift is undefined

Response body

Empty body

Lock lateral

Lock lateral by UUID. Metadata and trajectory updates and the deletion of a locked lateral are rejected with 403 until it is unlocked. A private lateral cannot be locked (403). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/wells/fcd47eba-39ca-4ab1-a9a9-009c0a054960/lock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/wells/fcd47eba-39ca-4ab1-a9a9-009c0a054960/lock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 06f93787b3338620623d943394672198

PATCH /public/api/v1/wells/{uuid}/lock

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Unlock lateral

Unlock lateral by UUID. A private lateral cannot be unlocked (403). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/wells/d4ba0aaa-f3c2-4bff-af1b-fbf200952478/unlock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/wells/d4ba0aaa-f3c2-4bff-af1b-fbf200952478/unlock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 38865d584ee9ff73e0ef5b14d3fa0341

PATCH /public/api/v1/wells/{uuid}/unlock

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Delete lateral

Delete lateral by UUID. The lateral is also removed from virtual projects and well lists. Returns 403 if the lateral is locked or is a private lateral of another user

Request

$ curl 'https://solo.cloud/public/api/v1/wells/bc42a65a-2ceb-41ec-9376-8712dd7a39ee' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/wells/bc42a65a-2ceb-41ec-9376-8712dd7a39ee HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 7ed7ca17d19418d2be119fb9006811c9

DELETE /public/api/v1/wells/{uuid}

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

3. Interpretations

Create interpretation

Create an empty public interpretation owned by the caller by lateral UUID. Add segments with Add interpretation segment or Write interpretation segments in bulk

Request

$ curl 'https://solo.cloud/public/api/v1/wells/8b7b4b03-cbcd-4bb9-994c-40e798e67442/interpretations' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Interpretation name"
}'

POST /public/api/v1/wells/8b7b4b03-cbcd-4bb9-994c-40e798e67442/interpretations HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 36

{
  "name" : "Interpretation name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 42dddbd2a422305ed3e5b3ff55880621
Content-Type: application/json

{
  "uuid" : "f2d01ac4-94ca-4f0d-b9cc-27e3928223b8"
}

POST /public/api/v1/wells/{uuid}/interpretations

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Interpretation name, required, not blank, at most 255 characters

Response body

Path Type Description
uuid String Created interpretation UUID

Write interpretation segments in bulk

Create or overwrite one interpretation of the lateral with all its segments in a single request. Either the whole interpretation is written or nothing is, a refused request leaves the target as it was.

The target is addressed by uuid, or by name when uuid is omitted. An existing target gets its segments fully replaced and the response carries created: false. When no interpretation with such name exists, a new one is created as a copy of source_interpretation_uuid (horizons included, owner is the caller, privacy is taken from private) and the response carries created: true; source_interpretation_uuid is required in this case. Sending the same request twice therefore yields one interpretation written twice, so a retry is safe. Concurrent writes to one lateral are not supported, upload laterals in parallel but write each of them sequentially.

The interpretation name must start with the prefix configured on the server (AI_ by default), so a bulk write never overwrites an interpretation made by a user. It is at most 255 characters long, carries no control characters and neither starts nor ends with whitespace. A lateral holding several interpretations with the requested name is rejected with 400 listing the UUIDs of those the caller may address (other users' private ones are only counted), address the target by uuid instead. A locked target and a private interpretation of another user (as the target or as the source) are rejected with 403. The call requires both CREATE and UPDATE permissions on interpretations.

Segment rules:

One request carries at most 10000 segments (a server setting), a larger request is rejected with 400 naming the limit. Segment values are in project units, the same as the other segment endpoints. Note that a segment is described by its start MD and the vertical shifts at its ends, not by the md, dip and throw of Add interpretation segment.

Request

$ curl 'https://solo.cloud/public/api/v1/wells/6b65c5f8-a8d5-4d82-82f3-70216a0230c2/interpretations/bulk' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "AI_interpretation 1",
  "source_interpretation_uuid" : "41fa73d0-d2ea-451d-a50d-73def2492497",
  "private" : false,
  "segments" : [ {
    "start_md" : 1000.0,
    "start_shift" : 0.0,
    "end_shift" : 2.5
  }, {
    "start_md" : 1500.0,
    "start_shift" : 2.5,
    "end_shift" : 4.0
  } ]
}'

PUT /public/api/v1/wells/6b65c5f8-a8d5-4d82-82f3-70216a0230c2/interpretations/bulk HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 307

{
  "name" : "AI_interpretation 1",
  "source_interpretation_uuid" : "41fa73d0-d2ea-451d-a50d-73def2492497",
  "private" : false,
  "segments" : [ {
    "start_md" : 1000.0,
    "start_shift" : 0.0,
    "end_shift" : 2.5
  }, {
    "start_md" : 1500.0,
    "start_shift" : 2.5,
    "end_shift" : 4.0
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: d997ffa65d54402da465215c5b6dd052
Content-Type: application/json

{
  "uuid" : "84b5fb80-bd8b-426f-8b3c-3ce3e48a8cb1",
  "name" : "AI_interpretation 1",
  "segments_written" : 2,
  "created" : true
}

PUT /public/api/v1/wells/{uuid}/interpretations/bulk

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Target interpretation name, at most 255 characters, no control characters, no whitespace at either end. Must start with the configured prefix (AI_ by default), otherwise the request is rejected with 400
uuid String Target interpretation UUID. When omitted, the target is looked up by name among the lateral's interpretations; when present, name must match the interpretation name
source_interpretation_uuid String Interpretation of the same lateral the target is copied from, horizons included. Required only when the target does not exist yet and has to be created, ignored when the target exists
private Boolean Privacy of the created interpretation (false by default). Ignored when an existing interpretation is overwritten
segments Array Segments to write, at least one, in strictly increasing start_md order, the existing segments of the target are fully replaced
segments[].start_md Number Segment start measured depth in project units, within the trajectory MD range
segments[].start_shift Number Vertical shift at the segment start in project units. Used for the first segment and for a fault boundary only, otherwise the previous segment's end_shift is taken
segments[].end_shift Number Vertical shift at the segment end in project units

Response body

Path Type Description
uuid String Target interpretation UUID
name String Target interpretation name
segments_written Number Number of segments the interpretation holds after the write
created Boolean true if the interpretation was created, false if an existing interpretation was overwritten

Add interpretation segment

Add segment by interpretation UUID. The segment is set by md, dip and throw, its vertical section is calculated by the server. A locked interpretation and a private interpretation of another user are rejected with 403. A service (AUTO) interpretation is rejected with 400

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/a434c73c-f4f0-46bc-b03b-a5d5571c0648/segments?horizontal_scale=MD' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "uuid" : "25362938-8dae-4bbc-820e-4fce697c9cce",
  "md" : {
    "val" : 1500.0
  },
  "dip" : {
    "val" : 30.0
  },
  "throw" : {
    "val" : 15.0
  }
}'

POST /public/api/v1/interpretations/a434c73c-f4f0-46bc-b03b-a5d5571c0648/segments?horizontal_scale=MD HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 158

{
  "uuid" : "25362938-8dae-4bbc-820e-4fce697c9cce",
  "md" : {
    "val" : 1500.0
  },
  "dip" : {
    "val" : 30.0
  },
  "throw" : {
    "val" : 15.0
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 2a3773c4c0dafc8200b65c4681b40dcf

POST /public/api/v1/interpretations/{uuid}/segments

Path parameter Description
uuid Interpretation UUID
Parameter Description
horizontal_scale Horizontal scale for segment calculations. Available values: MD, THL, VS
Header Description
Authorization OAuth2 authorization header
Body field Type Description
uuid String Segment UUID. On add it is ignored and the server assigns the UUID of the new segment. On modification it selects the segment to change, an unknown UUID is rejected with 400
md.val Number Segment start measured depth in project units
dip.val Number Dip value in degrees
throw.val Number Throw value in project units

Response body

Empty body

Get interpretations by lateral

Get a list of interpretations by lateral UUID with pagination, sorted by name

The list carries the public and locked interpretations of the lateral, and the private ones belonging to the caller - somebody else's private interpretation is not listed. Service (AUTO) interpretations are not listed either. Clients that identify themselves by User-Agent as SoloConnect before 4.3.0, SoloConnectCloud before 1.3.0 or PythonSDK before 0.4.0 (default server settings) get only interpretations in the old (v1) format.

Request

$ curl 'https://solo.cloud/public/api/v1/wells/8b7b4b03-cbcd-4bb9-994c-40e798e67442/interpretations?filter=test&offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/wells/8b7b4b03-cbcd-4bb9-994c-40e798e67442/interpretations?filter=test&offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: c76f5dc362c55d71990b8515a5a0a9d6
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "61707c47-e9d4-400c-a61f-69c5fcca8ced",
    "name" : "test interpretation 1",
    "format" : {
      "extension_grid_uuid" : "00000000-0000-0000-0000-000000000000",
      "reverse_extension" : false,
      "auto_typewell_shift" : true
    },
    "mode" : "PUBLIC"
  }, {
    "uuid" : "55cf004b-977c-40c5-ade3-7101837bccfb",
    "name" : "test interpretation 2",
    "format" : {
      "extension_grid_uuid" : "00000000-0000-0000-0000-000000000000",
      "reverse_extension" : false,
      "auto_typewell_shift" : true
    },
    "mode" : "PUBLIC"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/interpretations

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the interpretations whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Interpretation name
content[].uuid String Interpretation UUID
content[].format.extension_grid_uuid String Extension grid UUID, 00000000-0000-0000-0000-000000000000 when not set
content[].format.reverse_extension Boolean If true, the interpretation extension is reversed, false when not set
content[].format.auto_typewell_shift Boolean StarSteer "Auto typewell shift" setting of the Geosteering mode, true unless it was turned off. If true, tops and horizons with the same name always match in the TVT scale
content[].mode String PUBLIC, PRIVATE or LOCKED. A PRIVATE interpretation is listed only for its owner

Get segments by interpretation

Get a list of segments by interpretation UUID

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/aaafeecf-c2aa-4521-ac6d-e165dacbd5d5/segments?horizontal_scale=MD' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/interpretations/aaafeecf-c2aa-4521-ac6d-e165dacbd5d5/segments?horizontal_scale=MD HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 9be263241c23cc6fb7d36f5be7b4e6ae
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "72657b4a-2c2c-464c-b5c0-9c506d5bee22",
    "md" : {
      "val" : 0.0
    },
    "vs" : {
      "val" : 3.280839895013123
    },
    "dip" : {
      "val" : 97.19791814183668
    },
    "dip_equal_thickness" : false,
    "throw_equal_thickness" : true,
    "throw" : {
      "val" : 0.0
    }
  }, {
    "uuid" : "d1c3ff11-f0ac-4449-a772-05605f6a41b3",
    "md" : {
      "val" : 328.0839895013123
    },
    "vs" : {
      "val" : -0.615877064815856
    },
    "dip" : {
      "val" : 90.00000000000594
    },
    "dip_equal_thickness" : true,
    "throw_equal_thickness" : false,
    "throw" : {
      "val" : 0.49212598425196846
    }
  }, {
    "uuid" : "b50bbab0-e04b-412f-b9bc-9d602ca50772",
    "md" : {
      "val" : 1500.0000000000005
    },
    "vs" : {
      "val" : -24.350204919093997
    },
    "dip" : {
      "undefined" : true
    },
    "dip_equal_thickness" : false,
    "throw_equal_thickness" : false,
    "throw" : {
      "undefined" : true
    }
  } ]
}

GET /public/api/v1/interpretations/{uuid}/segments

Path parameter Description
uuid Interpretation UUID
Parameter Description
horizontal_scale Horizontal scale for segment calculations. Available values: MD, THL, VS
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
content[].uuid String Segment UUID
content[].md.val Number Segment start measured depth in project units
content[].vs.val Number Vertical section at the segment start in project units
content[].dip.val Number Dip value in degrees
content[].dip.undefined Boolean If true, dip value is undefined
content[].dip_equal_thickness Boolean If true, dip is calculated with equal thickness
content[].throw.val Number Throw value in project units
content[].throw.undefined Boolean If true, throw value is undefined
content[].throw_equal_thickness Boolean If true, throw is calculated with equal thickness

Get starred objects

Get starred objects by interpretation UUID

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/50d92177-99d4-4be2-a85e-a88fe0d16f84/starred' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/interpretations/50d92177-99d4-4be2-a85e-a88fe0d16f84/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 6b28298b39cb0b9088477b05e71581fe
Content-Type: application/json

{
  "top" : "20f37a98-63e5-4294-9d5e-d5a48bbd4206",
  "center" : "b2b964df-90e7-4acd-8f39-235a44da95fb",
  "bottom" : "19ac41f7-3091-43c0-a871-9716891ef6ab"
}

GET /public/api/v1/interpretations/{uuid}/starred

Path parameter Description
uuid Interpretation UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
top String Starred top horizon UUID, absent when not set or when the horizon no longer exists
center String Starred center horizon UUID, absent when not set or when the horizon no longer exists
bottom String Starred bottom horizon UUID, absent when not set or when the horizon no longer exists

Set starred objects

Set the starred top, center and bottom horizons by interpretation UUID. All three values are required and replace the current ones, 00000000-0000-0000-0000-000000000000 resets a position. A private interpretation of another user is rejected with 403. A service (AUTO) interpretation is rejected with 400

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/50d92177-99d4-4be2-a85e-a88fe0d16f84/starred' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "top" : "20f37a98-63e5-4294-9d5e-d5a48bbd4206",
  "center" : "b2b964df-90e7-4acd-8f39-235a44da95fb",
  "bottom" : "19ac41f7-3091-43c0-a871-9716891ef6ab"
}'

PUT /public/api/v1/interpretations/50d92177-99d4-4be2-a85e-a88fe0d16f84/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 158

{
  "top" : "20f37a98-63e5-4294-9d5e-d5a48bbd4206",
  "center" : "b2b964df-90e7-4acd-8f39-235a44da95fb",
  "bottom" : "19ac41f7-3091-43c0-a871-9716891ef6ab"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: eb7d966a3900e530a80e86ee45587d0a

PUT /public/api/v1/interpretations/{uuid}/starred

Path parameter Description
uuid Interpretation UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
top String Required. UUID of a horizon of this interpretation to be set as starred top, 00000000-0000-0000-0000-000000000000 resets it. Any other UUID is rejected with 400
center String Required. UUID of a horizon of this interpretation to be set as starred center, 00000000-0000-0000-0000-000000000000 resets it. Any other UUID is rejected with 400
bottom String Required. UUID of a horizon of this interpretation to be set as starred bottom, 00000000-0000-0000-0000-000000000000 resets it. Any other UUID is rejected with 400

Response body

Empty body

Get auto-typewells by interpretation

Get a list of auto-typewells by interpretation UUID. Only typewells linked to the lateral are considered. The list is empty when the interpretation has fewer than two horizons

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/05133053-2a61-4a18-82d8-8295eb3b33bc/autotypewells' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/interpretations/05133053-2a61-4a18-82d8-8295eb3b33bc/autotypewells HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 655798566ceac2e1ea0102d2cf426731
Content-Type: application/json

{
  "content" : [ {
    "auto_typewell_uuid" : "731c1e69-78c5-42f8-8976-4c825a6c1d12"
  } ]
}

GET /public/api/v1/interpretations/{uuid}/autotypewells

Path parameter Description
uuid Interpretation UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
content[].auto_typewell_uuid String Auto-typewell UUID

Set auto typewell shift

Turn the StarSteer "Auto typewell shift" setting of the Geosteering mode on or off for an interpretation. The current value is returned as format.auto_typewell_shift by "Get interpretations by lateral". Other interpretation settings are kept. A locked interpretation and a private interpretation of another user are rejected with 403. A service (AUTO) interpretation is rejected with 400

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/76c4e98b-090e-4e21-b731-427b2cd94c2d/autotypewellshift' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "enabled" : false
}'

PUT /public/api/v1/interpretations/76c4e98b-090e-4e21-b731-427b2cd94c2d/autotypewellshift HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 23

{
  "enabled" : false
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f41f4ace4423e4c915f6cfa6045cb851

PUT /public/api/v1/interpretations/{uuid}/autotypewellshift

Path parameter Description
uuid Interpretation UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
enabled Boolean Required. true turns the StarSteer "Auto typewell shift" setting on for the interpretation, false turns it off, other values (including the strings "true" and "false") are rejected with 400. The current value is returned as format.auto_typewell_shift by the interpretations list

Response body

Empty body

Modify interpretation segment

Modify segment by interpretation UUID. The segment is selected by uuid in the request body, an unknown segment UUID is rejected with 400. md, dip and throw are set, the vertical section is calculated by the server. A locked interpretation and a private interpretation of another user are rejected with 403. A service (AUTO) interpretation is rejected with 400

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/e609d09f-fae5-493e-be60-c4798be8146c/segments?horizontal_scale=MD' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "uuid" : "f1da77b0-9e51-419c-a662-ba9cd8156229",
  "md" : {
    "val" : 1500.0
  },
  "dip" : {
    "val" : 60.0
  },
  "throw" : {
    "val" : 25.0
  }
}'

PATCH /public/api/v1/interpretations/e609d09f-fae5-493e-be60-c4798be8146c/segments?horizontal_scale=MD HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 158

{
  "uuid" : "f1da77b0-9e51-419c-a662-ba9cd8156229",
  "md" : {
    "val" : 1500.0
  },
  "dip" : {
    "val" : 60.0
  },
  "throw" : {
    "val" : 25.0
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 941af35206a3115b6fe0afa51ffc200f

PATCH /public/api/v1/interpretations/{uuid}/segments

Path parameter Description
uuid Interpretation UUID
Parameter Description
horizontal_scale Horizontal scale for segment calculations. Available values: MD, THL, VS
Header Description
Authorization OAuth2 authorization header
Body field Type Description
uuid String Segment UUID. On add it is ignored and the server assigns the UUID of the new segment. On modification it selects the segment to change, an unknown UUID is rejected with 400
md.val Number Segment start measured depth in project units
dip.val Number Dip value in degrees
throw.val Number Throw value in project units

Response body

Empty body

Delete interpretation segment

Delete segment by interpretation UUID. A locked interpretation and a private interpretation of another user are rejected with 403. A service (AUTO) interpretation is rejected with 400

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/531df25d-311f-400d-90fb-4b60183bd9a3/segments/bb8a2dbf-8171-42fa-b010-9ef76a71ecba' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/interpretations/531df25d-311f-400d-90fb-4b60183bd9a3/segments/bb8a2dbf-8171-42fa-b010-9ef76a71ecba HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 4636b387031dba77771982485b40494e

DELETE /public/api/v1/interpretations/{uuid}/segments/{segmentUuid}

Path parameter Description
uuid Interpretation UUID
segmentUuid Segment UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Lock interpretation

Lock interpretation by UUID. Segment, auto typewell shift, bulk and earth model writes of a locked interpretation are rejected with 403 until it is unlocked. A private interpretation cannot be locked (403). A service (AUTO) interpretation cannot be locked (400). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/5d062561-77a4-4021-afba-5efce94ec4e6/lock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/interpretations/5d062561-77a4-4021-afba-5efce94ec4e6/lock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 03b9ca2b5cd41a77134b0e6c8a0699f0

PATCH /public/api/v1/interpretations/{uuid}/lock

Path parameter Description
uuid Interpretation UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Unlock interpretation

Unlock interpretation by UUID, the interpretation becomes public. A private interpretation cannot be unlocked (403). A service (AUTO) interpretation cannot be unlocked (400). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/459993fa-c6be-4b2d-85cd-e189c1e25879/unlock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/interpretations/459993fa-c6be-4b2d-85cd-e189c1e25879/unlock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 329b103111fe59a970a72377ac37a62e

PATCH /public/api/v1/interpretations/{uuid}/unlock

Path parameter Description
uuid Interpretation UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

4. Horizons

Get horizons metadata

Get a list of horizons by interpretation UUID with pagination, sorted by name

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/4d11804b-b7b8-416c-8e4e-4b5aafec4305/horizons?filter=tEst&offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/interpretations/4d11804b-b7b8-416c-8e4e-4b5aafec4305/horizons?filter=tEst&offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 109b9f7c39bcfb192ca5de937e5c2a02
Content-Type: application/json

{
  "content" : [ {
    "name" : "Test horizon 1",
    "uuid" : "e1929d61-46c9-4925-bb6b-c845bded63e0"
  }, {
    "name" : "Test horizon 2",
    "uuid" : "0a4c8820-7a83-43c7-8a09-90484931125b"
  }, {
    "name" : "Test horizon 3",
    "uuid" : "84ee41a8-cf5a-402d-b58e-b342f8adbbe4"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 3,
  "first" : true,
  "last" : true
}

GET /public/api/v1/interpretations/{uuid}/horizons

Path parameter Description
uuid Interpretation UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the horizons whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Horizon name
content[].uuid String Horizon UUID

Get horizons data by interpretation

Get calculated horizons data by interpretation UUID. Points are returned along the lateral from the start of the first interpretation segment to the trajectory end: at that start, at every MD multiple of spacing in between and at the trajectory end, each with the well position and the TVDSS of every horizon of the interpretation

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/376e4bf4-1625-463a-8fc7-266bcd03e651/horizons/data/spacing/5000' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/interpretations/376e4bf4-1625-463a-8fc7-266bcd03e651/horizons/data/spacing/5000 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 7e309880aa57d4695136ae2ad9f38eee
Content-Type: application/json

{
  "content" : [ {
    "azimuth" : {
      "val" : 71.543
    },
    "horizons" : [ {
      "name" : "!new Hor",
      "tvdss" : {
        "val" : 22.965879265091868
      },
      "uuid" : "b65b8a16-cc3c-4b3e-88d0-4e764677f99a"
    }, {
      "name" : "Horizon1",
      "tvdss" : {
        "val" : -3257.8740157480324
      },
      "uuid" : "5e1db2e0-329e-4447-8900-986eee97f3b6"
    } ],
    "inclination" : {
      "val" : 0
    },
    "kb" : {
      "val" : 22.965879265091868
    },
    "md" : {
      "val" : 0
    },
    "tvt" : {
      "val" : 0
    },
    "vs_azim" : {
      "azimuth" : {
        "val" : 0
      },
      "vs" : {
        "val" : 3.280839895013124
      }
    },
    "well_name" : "Lateral",
    "x" : {
      "val" : 19.68503937007874
    },
    "y" : {
      "val" : 36.08923884514436
    },
    "z" : {
      "val" : 22.965879265091868
    }
  }, {
    "azimuth" : {
      "val" : 149.253
    },
    "horizons" : [ {
      "name" : "!new Hor",
      "tvdss" : {
        "val" : 22.965879265091868
      },
      "uuid" : "b65b8a16-cc3c-4b3e-88d0-4e764677f99a"
    }, {
      "name" : "Horizon1",
      "tvdss" : {
        "val" : -3257.8740157480324
      },
      "uuid" : "5e1db2e0-329e-4447-8900-986eee97f3b6"
    } ],
    "inclination" : {
      "val" : 1.33
    },
    "kb" : {
      "val" : 22.965879265091868
    },
    "md" : {
      "val" : 3280.839895013124
    },
    "tvt" : {
      "val" : 3280.0196063852154
    },
    "vs_azim" : {
      "azimuth" : {
        "val" : 0
      },
      "vs" : {
        "val" : -60.07861128428071
      }
    },
    "well_name" : "Lateral",
    "x" : {
      "val" : 53.715600823725445
    },
    "y" : {
      "val" : -27.270212334149477
    },
    "z" : {
      "val" : -3257.0537271201238
    }
  } ]
}

GET /public/api/v1/interpretations/{uuid}/horizons/data/spacing/{spacing}

Path parameter Description
uuid Interpretation UUID
spacing MD step of the returned points in project units (points are placed at MD multiples of it), an integer in [1;100000], other values are rejected with 400
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content[].azimuth.val Number Well azimuth (degrees)
content[].inclination.val Number Well inclination (degrees)
content[].kb.val Number KB (project units)
content[].md.val Number MD (project units)
content[].tvt.val Number TVT (project units)
content[].well_name String Well name
content[].x.val Number X (project units)
content[].y.val Number Y (project units)
content[].z.val Number Z (project units)
content[].vs_azim.azimuth.val Number Vertical section azimuth of the lateral (degrees)
content[].vs_azim.vs.val Number VS (project units)
content[].horizons[].name String Horizon name
content[].horizons[].tvdss.val Number TVDSS (project units)
content[].horizons[].uuid String Horizon UUID

Get horizons data by lateral

Get calculated horizons data by lateral UUID, one interpretation per page: offset selects the interpretation among those Get interpretations by lateral returns (sorted by name, the caller's own private interpretations included, the same User-Agent rule applied), interpretation names it and content carries its points as in Get horizons data by interpretation

Request

$ curl 'https://solo.cloud/public/api/v1/wells/9f917b69-3882-451b-bcdd-f51ddef9d4d7/horizons/data/spacing/5000?offset=0' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/wells/9f917b69-3882-451b-bcdd-f51ddef9d4d7/horizons/data/spacing/5000?offset=0 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 8b6a21dc745f38805c62825d90c06f67
Content-Type: application/json

{
  "content" : [ {
    "azimuth" : {
      "val" : 71.543
    },
    "horizons" : [ {
      "name" : "!new Hor",
      "tvdss" : {
        "val" : 22.965879265091868
      },
      "uuid" : "b65b8a16-cc3c-4b3e-88d0-4e764677f99a"
    }, {
      "name" : "Horizon1",
      "tvdss" : {
        "val" : -3257.8740157480324
      },
      "uuid" : "5e1db2e0-329e-4447-8900-986eee97f3b6"
    } ],
    "inclination" : {
      "val" : 0
    },
    "kb" : {
      "val" : 22.965879265091868
    },
    "md" : {
      "val" : 0
    },
    "tvt" : {
      "val" : 0
    },
    "vs_azim" : {
      "azimuth" : {
        "val" : 0
      },
      "vs" : {
        "val" : 3.280839895013124
      }
    },
    "well_name" : "Lateral",
    "x" : {
      "val" : 19.68503937007874
    },
    "y" : {
      "val" : 36.08923884514436
    },
    "z" : {
      "val" : 22.965879265091868
    }
  }, {
    "azimuth" : {
      "val" : 149.253
    },
    "horizons" : [ {
      "name" : "!new Hor",
      "tvdss" : {
        "val" : 22.965879265091868
      },
      "uuid" : "b65b8a16-cc3c-4b3e-88d0-4e764677f99a"
    }, {
      "name" : "Horizon1",
      "tvdss" : {
        "val" : -3257.8740157480324
      },
      "uuid" : "5e1db2e0-329e-4447-8900-986eee97f3b6"
    } ],
    "inclination" : {
      "val" : 1.33
    },
    "kb" : {
      "val" : 22.965879265091868
    },
    "md" : {
      "val" : 3280.839895013124
    },
    "tvt" : {
      "val" : 3280.0196063852154
    },
    "vs_azim" : {
      "azimuth" : {
        "val" : 0
      },
      "vs" : {
        "val" : -60.07861128428071
      }
    },
    "well_name" : "Lateral",
    "x" : {
      "val" : 53.715600823725445
    },
    "y" : {
      "val" : -27.270212334149477
    },
    "z" : {
      "val" : -3257.0537271201238
    }
  } ],
  "interpretation" : {
    "name" : "Interpretation",
    "uuid" : "376e4bf4-1625-463a-8fc7-266bcd03e651"
  },
  "offset" : 0,
  "limit" : 1,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/horizons/data/spacing/{spacing}

Path parameter Description
uuid Lateral UUID
spacing MD step of the returned points in project units (points are placed at MD multiples of it), an integer in [1;100000], other values are rejected with 400
Parameter Description
offset Index of the interpretation to calculate the horizons for, in [0;total - 1], over the interpretations Get interpretations by lateral returns, sorted by name. An index beyond the last interpretation returns an empty content and no interpretation
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Calculated points of the selected interpretation
offset Number Index of the selected interpretation, as requested. An index beyond the last interpretation returns an empty content and no interpretation
limit Number Always 1
total Number Number of interpretations
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].azimuth.val Number Well azimuth (degrees)
content[].inclination.val Number Well inclination (degrees)
content[].kb.val Number KB (project units)
content[].md.val Number MD (project units)
content[].tvt.val Number TVT (project units)
content[].well_name String Well name
content[].x.val Number X (project units)
content[].y.val Number Y (project units)
content[].z.val Number Z (project units)
content[].vs_azim.azimuth.val Number Vertical section azimuth of the lateral (degrees)
content[].vs_azim.vs.val Number VS (project units)
content[].horizons[].name String Horizon name
content[].horizons[].tvdss.val Number TVDSS (project units)
content[].horizons[].uuid String Horizon UUID
interpretation.name String Interpretation name
interpretation.uuid String Interpretation UUID

5. Nested wells

Create nested well

Create nested well. Another term for a Nested well is a well plan. It's often referred to as a 'well plan object' in StarSteer and Solo

Request

$ curl 'https://solo.cloud/public/api/v1/wells/2165ce10-5e87-4ccd-9746-2994bf9956cb/nestedwells' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Nested well name",
  "operator" : "operator",
  "api" : "api",
  "xsrf" : {
    "val" : 0.1
  },
  "ysrf" : {
    "val" : 0.2
  },
  "kb" : {
    "val" : 0.3
  },
  "tie_in_tvd" : {
    "val" : 0.4
  },
  "tie_in_ns" : {
    "val" : 0.5
  },
  "tie_in_ew" : {
    "val" : 0.6
  }
}'

POST /public/api/v1/wells/2165ce10-5e87-4ccd-9746-2994bf9956cb/nestedwells HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 295

{
  "name" : "Nested well name",
  "operator" : "operator",
  "api" : "api",
  "xsrf" : {
    "val" : 0.1
  },
  "ysrf" : {
    "val" : 0.2
  },
  "kb" : {
    "val" : 0.3
  },
  "tie_in_tvd" : {
    "val" : 0.4
  },
  "tie_in_ns" : {
    "val" : 0.5
  },
  "tie_in_ew" : {
    "val" : 0.6
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 0f6c57f747e128fca5fa0137d31a165e
Content-Type: application/json

{
  "uuid" : "2c12ee04-3736-40d9-9247-d1a0c780ba4c"
}

POST /public/api/v1/wells/{uuid}/nestedwells

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Nested well name
operator String Operator name
api String API nested well number
xsrf.val Number X surface coordinate in project units
ysrf.val Number Y surface coordinate in project units
kb.val Number Kelly bushing (KB) elevation above MSL in project units
tie_in_ew.val Number Tie-in point EW in project units
tie_in_ns.val Number Tie-in point NS in project units
tie_in_tvd.val Number Tie-in point TVD in project units

Response body

Path Type Description
uuid String Created nested well UUID

Get nested wells by lateral

Get a list of nested wells by lateral UUID with pagination, sorted by name

Request

$ curl 'https://solo.cloud/public/api/v1/wells/d0eb4a64-2c46-4ab5-8652-5195028dffe1/nestedwells?offset=0&limit=10&filter=oNe' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/d0eb4a64-2c46-4ab5-8652-5195028dffe1/nestedwells?offset=0&limit=10&filter=oNe HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ad4ce3d9a03a8645d3914da89688bdb8
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "575f02c4-5725-4d73-a20f-ea810a3608ec",
    "name" : "Nested well one",
    "api" : "api nested well",
    "flags" : {
      "has_topsets" : false
    }
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/nestedwells

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the nested wells whose name or API contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Nested well UUID
content[].name String Nested well name
content[].api String API nested well number
content[].flags.has_topsets Boolean Flag indicating the presence of topsets

Get nested well metadata

Get nested well metadata by UUID. Values except the corridor ones are in project units. xsrf, ysrf and kb that are not set for the nested well (as parent) are returned from its lateral

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/36bc1f59-4f04-42f6-8f28-7be3b11f6c63' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/nestedwells/36bc1f59-4f04-42f6-8f28-7be3b11f6c63 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f4c454604e3837864379d38a75586bc6
Content-Type: application/json

{
  "name" : "Nested well one",
  "operator" : "string",
  "api" : "api nested well",
  "xsrf" : {
    "val" : 6.0
  },
  "ysrf" : {
    "val" : 10.0
  },
  "kb" : {
    "val" : 22.96587926509186
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 3.280839895013123
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}

GET /public/api/v1/nestedwells/{uuid}

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
name String Nested well name
operator String Operator name
api String API nested well number
xsrf.val Number X surface coordinate in project units. If it is not set for the nested well, the lateral value is returned
ysrf.val Number Y surface coordinate in project units. If it is not set for the nested well, the lateral value is returned
kb.val Number Kelly bushing (KB) elevation above MSL in project units. If it is not set for the nested well, the lateral value is returned
tie_in_tvd.val Number Tie-in point TVD in project units
tie_in_ns.val Number Tie-in point NS in project units
tie_in_ew.val Number Tie-in point EW in project units
corridor_top.val Number Well plan corridor top value as stored in the well plan properties, not converted to project units
corridor_base.val Number Well plan corridor base value as stored in the well plan properties, not converted to project units
corridor_left.val Number Well plan corridor left value as stored in the well plan properties, not converted to project units
corridor_right.val Number Well plan corridor right value as stored in the well plan properties, not converted to project units

Get nested well ellipses

Get nested well ellipses data by nested well UUID. Returns 404 if no ellipses are stored for the nested well

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/affc3bea-1ea0-4f1b-9480-8a3c68605c4e/ellipses' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/nestedwells/affc3bea-1ea0-4f1b-9480-8a3c68605c4e/ellipses HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 63d92139d3153c14e240fb94393c4dfb
Content-Type: application/json

{
  "content" : [ {
    "index" : 10.0,
    "value" : {
      "nev" : [ 14.99, 98.23, 41.2, 67.78, 23.89, 12.31, 55.43, 11.23, 34.33 ],
      "messages" : [ ]
    }
  } ]
}

GET /public/api/v1/nestedwells/{nestedWellUuid}/ellipses

Path parameter Description
nestedWellUuid Nested well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Ellipses points array sorted by index ascending
content[].index Number Measured Depth value of the point
content[].value.nev Array Ellipse attributes
content[].value.messages Array Comments

Get starred topset

Get starred topset by nested well UUID

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/96c961d2-ca95-44e6-a264-43b92e61cd6a/starred' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/nestedwells/96c961d2-ca95-44e6-a264-43b92e61cd6a/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f19297b7279377b2d6e1b96b651818dc
Content-Type: application/json

{
  "topset" : "8205e8fa-9466-4caa-99e6-a973b5c628be"
}

GET /public/api/v1/nestedwells/{uuid}/starred

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
topset String Starred topset UUID. Absent when no topset is starred or the starred topset was deleted

Update nested well metadata

Update nested well metadata by UUID. Fields that are not sent keep their current values. Values are in project units. Returns 403 if the nested well is locked or is a private nested well of another user

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/faf32489-edeb-4149-b250-eed000f821a0' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Nested well new name",
  "api" : "api nested well",
  "operator" : "string",
  "xsrf" : {
    "val" : 6.0
  },
  "ysrf" : {
    "val" : 10.0
  },
  "kb" : {
    "val" : 7.0
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 1.0
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}'

PATCH /public/api/v1/nestedwells/faf32489-edeb-4149-b250-eed000f821a0 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 310

{
  "name" : "Nested well new name",
  "api" : "api nested well",
  "operator" : "string",
  "xsrf" : {
    "val" : 6.0
  },
  "ysrf" : {
    "val" : 10.0
  },
  "kb" : {
    "val" : 7.0
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 1.0
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 2a536e67a4515546ff385c55f73a167d

PATCH /public/api/v1/nestedwells/{uuid}

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Nested well name, up to 200 characters, must not be blank if sent
operator String Operator name, up to 200 characters
api String API nested well number, up to 200 characters
xsrf.val Number X surface coordinate in project units
xsrf.undefined Boolean If true then X surface coordinate will be set as parent (the lateral value is returned)
ysrf.val Number Y surface coordinate in project units
ysrf.undefined Boolean If true then Y surface coordinate will be set as parent (the lateral value is returned)
kb.val Number Kelly bushing (KB) elevation above MSL in project units
kb.undefined Boolean If true then KB will be set as parent (the lateral value is returned)
tie_in_tvd.val Number Tie-in point TVD in project units
tie_in_tvd.undefined Boolean If true then tie in TVD will be set undefined
tie_in_ns.val Number Tie-in point NS in project units
tie_in_ns.undefined Boolean If true then tie in NS will be set undefined
tie_in_ew.val Number Tie-in point EW in project units
tie_in_ew.undefined Boolean If true then tie in EW will be set undefined

Response body

Empty body

Set starred topset

Set starred topset by nested well UUID. The topset must belong to the nested well, the zero UUID 00000000-0000-0000-0000-000000000000 resets the starred topset. Any other UUID is rejected with 406. A private nested well of another user is rejected with 403

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/524a2d6b-b1e4-4d33-8f7d-6ae93fa9ee79/starred' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "topset" : "b0ec121a-65fc-45ca-a0b9-0635a491861e"
}'

PUT /public/api/v1/nestedwells/524a2d6b-b1e4-4d33-8f7d-6ae93fa9ee79/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 55

{
  "topset" : "b0ec121a-65fc-45ca-a0b9-0635a491861e"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: bc09583efb3a5d9755545bf7f0727e5c

PUT /public/api/v1/nestedwells/{uuid}/starred

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
topset String UUID of a topset of this nested well to set starred (use "00000000-0000-0000-0000-000000000000" to reset). Any other UUID is rejected with 406

Response body

Empty body

Lock nested well

Lock nested well by UUID. The metadata and trajectory of a locked nested well cannot be updated and the nested well cannot be deleted (403) until it is unlocked. A private nested well cannot be locked (403). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/8b47b0ba-ed57-4fdb-9cee-051b5e77fd27/lock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/nestedwells/8b47b0ba-ed57-4fdb-9cee-051b5e77fd27/lock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: c59680a102d86a1048c23701465fdbb8

PATCH /public/api/v1/nestedwells/{uuid}/lock

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Unlock nested well

Unlock nested well by UUID. A private nested well cannot be unlocked (403). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/29fbf319-cd5f-4633-a80e-257c7c86f0e7/unlock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/nestedwells/29fbf319-cd5f-4633-a80e-257c7c86f0e7/unlock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 860f9d53c4d0662d21bf99631811db05

PATCH /public/api/v1/nestedwells/{uuid}/unlock

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Delete nested well

Delete nested well by UUID. Returns 403 if the nested well is locked or is a private nested well of another user

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/27984767-aae2-432a-b7f2-41485c291f20' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/nestedwells/27984767-aae2-432a-b7f2-41485c291f20 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 774c90de3bfd91df92f99c415fd50b63

DELETE /public/api/v1/nestedwells/{uuid}

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

6. Typewells

Create typewell

Create typewell by project UUID

Request

$ curl 'https://solo.cloud/public/api/v1/projects/ef1603ed-5e77-47fc-9b75-ee3586a36be3/typewells' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Typewell name",
  "operator" : "operator",
  "api" : "api",
  "convergence" : {
    "val" : 90.0
  },
  "azimuth" : {
    "val" : 45.0
  },
  "kb" : {
    "val" : 0.3
  },
  "tieintvd" : {
    "val" : 0.4
  },
  "tieinns" : {
    "val" : 0.5
  },
  "tieinew" : {
    "val" : 0.6
  },
  "xsrfreal" : {
    "val" : 100.0
  },
  "ysrfreal" : {
    "val" : 500.0
  }
}'

POST /public/api/v1/projects/ef1603ed-5e77-47fc-9b75-ee3586a36be3/typewells HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 378

{
  "name" : "Typewell name",
  "operator" : "operator",
  "api" : "api",
  "convergence" : {
    "val" : 90.0
  },
  "azimuth" : {
    "val" : 45.0
  },
  "kb" : {
    "val" : 0.3
  },
  "tieintvd" : {
    "val" : 0.4
  },
  "tieinns" : {
    "val" : 0.5
  },
  "tieinew" : {
    "val" : 0.6
  },
  "xsrfreal" : {
    "val" : 100.0
  },
  "ysrfreal" : {
    "val" : 500.0
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: faf301b43ab1155f2013e3d8e5c466c4
Content-Type: application/json

{
  "uuid" : "9d0bcea7-a2b6-4290-af33-879299fa6613"
}

POST /public/api/v1/projects/{uuid}/typewells

Path parameter Description
uuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Typewell name
operator String Operator name
api String API typewell number
convergence.val Number Grid convergence angle in degrees
azimuth.val Number Vertical section azimuth in degrees
kb.val Number Kelly bushing (KB) elevation above MSL in project units
tieintvd.val Number Tie-in point TVD in project units
tieinns.val Number Tie-in point NS in project units
tieinew.val Number Tie-in point EW in project units
xsrfreal.val Number X surface coordinate in project units
ysrfreal.val Number Y surface coordinate in project units

Response body

Path Type Description
uuid String Created typewell UUID

Get typewells by project

Get a list of typewells by project UUID with pagination, sorted by name. A virtual project UUID is also accepted, then only the typewells added to that virtual project are listed

Request

$ curl 'https://solo.cloud/public/api/v1/projects/ef1603ed-5e77-47fc-9b75-ee3586a36be3/typewells?offset=0&limit=10&filter=oNe' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/ef1603ed-5e77-47fc-9b75-ee3586a36be3/typewells?offset=0&limit=10&filter=oNe HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 9bb1ee974c24d98b72bb591d166fd661
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "72269dac-3165-4910-9f45-90d4a75e4930",
    "name" : "Typewell one",
    "api" : "api typewell one",
    "flags" : {
      "has_logs" : false,
      "has_topsets" : false,
      "has_mudlogs" : false
    }
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{uuid}/typewells

Path parameter Description
uuid Project UUID (a virtual project UUID is also accepted)
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the typewells whose name or API contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Typewell UUID
content[].name String Typewell name
content[].api String API typewell number
content[].flags.has_logs Boolean Flag indicating the presence of logs with data (logs without data are not counted)
content[].flags.has_topsets Boolean Flag indicating the presence of topsets
content[].flags.has_mudlogs Boolean Flag indicating the presence of mudlogs with data (mudlogs without data are not counted)

Get typewell metadata

Get typewell metadata by UUID. Values are in project units, convergence is in degrees

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/396ae681-8679-4250-9e00-169d2a48411d' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/typewells/396ae681-8679-4250-9e00-169d2a48411d HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 506c216866b523d3aa03ba58c3765f3f
Content-Type: application/json

{
  "uuid" : "396ae681-8679-4250-9e00-169d2a48411d",
  "name" : "Typewell",
  "operator" : "string",
  "api" : "string",
  "xsrf" : {
    "val" : 19.68503937007874
  },
  "ysrf" : {
    "val" : 32.808398950131235
  },
  "kb" : {
    "val" : 22.96587926509186
  },
  "convergence" : {
    "val" : 0.0
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 3.280839895013123
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}

GET /public/api/v1/typewells/{uuid}

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
uuid String Typewell UUID
name String Typewell name
operator String Operator name
api String API typewell number
xsrf.val Number X surface coordinate in project units
ysrf.val Number Y surface coordinate in project units
kb.val Number Kelly bushing (KB) elevation above MSL in project units
convergence.val Number Grid convergence angle in degrees
tie_in_tvd.val Number Tie-in point TVD in project units
tie_in_ns.val Number Tie-in point NS in project units
tie_in_ew.val Number Tie-in point EW in project units

Get typewell ellipses

Get typewell ellipses data by typewell UUID. Returns 404 if no ellipses are stored for the typewell

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/6e07efa6-6452-4e53-bf35-40025754ea93/ellipses' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/6e07efa6-6452-4e53-bf35-40025754ea93/ellipses HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: c0da6aaae60bf426a84602b807734894
Content-Type: application/json

{
  "content" : [ {
    "index" : 10.0,
    "value" : {
      "nev" : [ 14.99, 98.23, 41.2, 67.78, 23.89, 12.31, 55.43, 11.23, 34.33 ],
      "messages" : [ ]
    }
  } ]
}

GET /public/api/v1/typewells/{typewellUuid}/ellipses

Path parameter Description
typewellUuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Ellipses points array sorted by index ascending
content[].index Number Measured Depth value of the point
content[].value.nev Array Ellipse attributes
content[].value.messages Array Comments

Get starred topset

Get starred topset by typewell UUID

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/396ae681-8679-4250-9e00-169d2a48411d/starred' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/typewells/396ae681-8679-4250-9e00-169d2a48411d/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 831853772c9c7804aeb92bf244fe25b1
Content-Type: application/json

{
  "topset" : "2e6accad-1cbc-46d8-be52-5019e1a0688c"
}

GET /public/api/v1/typewells/{uuid}/starred

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
topset String Starred topset UUID. Absent when no topset is starred or the starred topset was deleted

Get linked laterals

Get laterals linked to the typewell by typewell UUID with pagination. Only active links are returned, in the order the links were created. shift is in project units

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/3262b3e3-b6ff-4409-ac58-54c7c15d7dc3/linked?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/typewells/3262b3e3-b6ff-4409-ac58-54c7c15d7dc3/linked?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: a1078890dd45bbbf50936d4b644fe55b
Content-Type: application/json

{
  "content" : [ {
    "shift" : {
      "val" : 1640.4199475065616
    },
    "lateral_id" : "9ea6f145-9482-4651-b681-093485033f5f"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/typewells/{uuid}/linked

Path parameter Description
uuid Typewell UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].shift.val Number Typewell shift for the linked lateral in project units
content[].lateral_id String Linked lateral UUID

Update typewell metadata

Update typewell metadata by UUID. Fields that are not sent keep their current values. Values are in project units, convergence is in degrees. Returns 403 if the typewell is locked or is a private typewell of another user

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/72269dac-3165-4910-9f45-90d4a75e4930' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Typewell one",
  "api" : "api typewell",
  "operator" : "string",
  "xsrf" : {
    "val" : 6.0
  },
  "ysrf" : {
    "val" : 10.0
  },
  "kb" : {
    "val" : 7.0
  },
  "convergence" : {
    "val" : 0.0
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 1.0
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}'

PATCH /public/api/v1/typewells/72269dac-3165-4910-9f45-90d4a75e4930 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 340

{
  "name" : "Typewell one",
  "api" : "api typewell",
  "operator" : "string",
  "xsrf" : {
    "val" : 6.0
  },
  "ysrf" : {
    "val" : 10.0
  },
  "kb" : {
    "val" : 7.0
  },
  "convergence" : {
    "val" : 0.0
  },
  "tie_in_tvd" : {
    "val" : 0.0
  },
  "tie_in_ns" : {
    "val" : 1.0
  },
  "tie_in_ew" : {
    "val" : 0.0
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 2b3cc605056e057d93d0fa5c95b63b80

PATCH /public/api/v1/typewells/{uuid}

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Typewell name, up to 200 characters, must not be blank if sent
operator String Operator name, up to 200 characters
api String API typewell number, up to 200 characters
xsrf.val Number X surface coordinate in project units
ysrf.val Number Y surface coordinate in project units
kb.val Number Kelly bushing (KB) elevation above MSL in project units
convergence.val Number Grid convergence angle in degrees
tie_in_tvd.val Number Tie-in point TVD in project units
tie_in_ns.val Number Tie-in point NS in project units
tie_in_ew.val Number Tie-in point EW in project units

Response body

Empty body

Set starred topset

Set starred topset by typewell UUID. The topset must belong to the typewell, the zero UUID 00000000-0000-0000-0000-000000000000 resets the starred topset. Any other UUID is rejected with 406. A private typewell of another user is rejected with 403

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/396ae681-8679-4250-9e00-169d2a48411d/starred' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "topset" : "2e6accad-1cbc-46d8-be52-5019e1a0688c"
}'

PUT /public/api/v1/typewells/396ae681-8679-4250-9e00-169d2a48411d/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 55

{
  "topset" : "2e6accad-1cbc-46d8-be52-5019e1a0688c"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 1d2f1e270ad493d693113d08525475de

PUT /public/api/v1/typewells/{uuid}/starred

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
topset String UUID of a topset of this typewell to set starred (use "00000000-0000-0000-0000-000000000000" to reset). Any other UUID is rejected with 406

Response body

Empty body

Lock typewell

Lock typewell by UUID. The metadata and trajectory of a locked typewell cannot be updated and the typewell cannot be deleted (403) until it is unlocked. A private typewell cannot be locked (403). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/e2148abe-0204-4efb-a082-1460117b2786/lock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/typewells/e2148abe-0204-4efb-a082-1460117b2786/lock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 5ecea3feca69932b4b312c3b0eb4f6b4

PATCH /public/api/v1/typewells/{uuid}/lock

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Unlock typewell

Unlock typewell by UUID. A private typewell cannot be unlocked (403). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/0e87cba4-64a5-4639-bc1b-0e94d31f334f/unlock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/typewells/0e87cba4-64a5-4639-bc1b-0e94d31f334f/unlock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 37f23599d09f67c6e3c9708053d0b07b

PATCH /public/api/v1/typewells/{uuid}/unlock

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Delete typewell

Delete typewell by UUID. The links of laterals to the typewell are deactivated, the typewell is also removed from virtual projects and well lists. Returns 403 if the typewell is locked or is a private typewell of another user

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/603c26af-e970-4979-a240-b882fad411a5' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/typewells/603c26af-e970-4979-a240-b882fad411a5 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: a3bc7cc5dcc27c895fd8d6d6bfca5710

DELETE /public/api/v1/typewells/{uuid}

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

7. Topsets

Create lateral topset

Create topset by lateral UUID

Request

$ curl 'https://solo.cloud/public/api/v1/wells/bf615764-66c5-4ffd-b44a-c7a7f216672d/topsets' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Topset name"
}'

POST /public/api/v1/wells/bf615764-66c5-4ffd-b44a-c7a7f216672d/topsets HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 28

{
  "name" : "Topset name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 0ecfa20be997ea91e4acee8cdc29e015
Content-Type: application/json

{
  "uuid" : "e55ed10b-4c51-499a-b039-97d3133df2ca"
}

POST /public/api/v1/wells/{uuid}/topsets

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Topset name (up to 1000 characters)

Response body

Path Type Description
uuid String Created topset UUID

Create typewell topset

Create topset by typewell UUID

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/92cd7c2c-6e67-409a-a8fc-ce2324433ca0/topsets' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Topset name"
}'

POST /public/api/v1/typewells/92cd7c2c-6e67-409a-a8fc-ce2324433ca0/topsets HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 28

{
  "name" : "Topset name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 2868aba5188e7ccfd590e129c6b992b9
Content-Type: application/json

{
  "uuid" : "8d1f2fb3-4f26-477d-8bd7-c8bf1e1349f0"
}

POST /public/api/v1/typewells/{uuid}/topsets

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Topset name (up to 1000 characters)

Response body

Path Type Description
uuid String Created topset UUID

Create nested well topset

Create topset by nested well UUID

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/cc288539-e5e6-4496-a4aa-42bb9d940343/topsets' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Topset name"
}'

POST /public/api/v1/nestedwells/cc288539-e5e6-4496-a4aa-42bb9d940343/topsets HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 28

{
  "name" : "Topset name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ad89a9ee74ef40dacb08118e61e8cd25
Content-Type: application/json

{
  "uuid" : "17abc676-6d1d-4ff6-85fe-fe36e7c05d9a"
}

POST /public/api/v1/nestedwells/{uuid}/topsets

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Topset name (up to 1000 characters)

Response body

Path Type Description
uuid String Created topset UUID

Create lateral topset with tops

Create a topset together with its tops by lateral UUID in one request. Each top takes the same fields as in Create top, invalid attribute values are rejected with 400. md is in project units and must be in [0;100000] range, otherwise the request is rejected with 406. An undefined md is stored as 0. The response holds the UUIDs of the created topset and tops, top_uuids is not guaranteed to follow the order of the request

Request

$ curl 'https://solo.cloud/public/api/v1/wells/bf615764-66c5-4ffd-b44a-c7a7f216672d/topsets/bulk' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Topset with tops",
  "tops" : [ {
    "name" : "Top 1",
    "md" : {
      "val" : 100.0
    },
    "dip" : {
      "val" : 4.2
    },
    "azimuth" : {
      "val" : 127.3
    },
    "dip_classification" : "bedding",
    "confidence" : {
      "val" : 0.94
    },
    "source" : "ai",
    "model_info" : "WI_BeddingPlane_v2.1"
  }, {
    "name" : "Top 2",
    "md" : {
      "val" : 200.0
    }
  } ]
}'

POST /public/api/v1/wells/bf615764-66c5-4ffd-b44a-c7a7f216672d/topsets/bulk HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 417

{
  "name" : "Topset with tops",
  "tops" : [ {
    "name" : "Top 1",
    "md" : {
      "val" : 100.0
    },
    "dip" : {
      "val" : 4.2
    },
    "azimuth" : {
      "val" : 127.3
    },
    "dip_classification" : "bedding",
    "confidence" : {
      "val" : 0.94
    },
    "source" : "ai",
    "model_info" : "WI_BeddingPlane_v2.1"
  }, {
    "name" : "Top 2",
    "md" : {
      "val" : 200.0
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 821b290772abfc1ad6af721553fe6476
Content-Type: application/json

{
  "topset_uuid" : "ca8a1e3f-8e57-4fd7-9885-6337b9b332ba",
  "top_uuids" : [ "02bf8666-16e4-4de6-9d83-2fbe876b5d3d", "6e662060-3dd7-454e-ab9f-0d8223936dbf" ]
}

POST /public/api/v1/wells/{uuid}/topsets/bulk

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Topset name (up to 1000 characters, required)
tops Array Tops to create in the topset, at least one
tops[].name String Top name (up to 1000 characters, required)
tops[].md Object Measured depth (required). If present val is set, otherwise undefined is true
tops[].md.val Number Measured depth value in project units, must be in [0;100000] range, otherwise 406 is returned
tops[].md.undefined Boolean Set to true if MD is undefined, MD is then stored as 0
tops[].dip Object Dip. If present val is set, otherwise undefined is true
tops[].dip.val Number Dip value in degrees, must be in [0;90] range, otherwise 400 is returned
tops[].dip.undefined Boolean Set to true if dip is undefined
tops[].azimuth Object Azimuth. If present val is set, otherwise undefined is true
tops[].azimuth.val Number Azimuth value in degrees, must be in [0;360) range, otherwise 400 is returned
tops[].azimuth.undefined Boolean Set to true if azimuth is undefined
tops[].dip_classification String Dip classification, must be null or one of: bedding, thin_bed, fault, fracture_open, fracture_healed, fracture_induced, otherwise 400 is returned
tops[].confidence Object Confidence. If present val is set, otherwise undefined is true
tops[].confidence.val Number Confidence value, must be in [0;1] range, otherwise 400 is returned
tops[].confidence.undefined Boolean Set to true if confidence is undefined
tops[].source String Top source, must be null or one of: manual, ai, otherwise 400 is returned
tops[].model_info String Model info

Response body

Path Type Description
topset_uuid String Created topset UUID
top_uuids Array UUIDs of the created tops

Create typewell topset with tops

Create a topset together with its tops by typewell UUID in one request. Each top takes the same fields as in Create top, invalid attribute values are rejected with 400. md is in project units and must be in [0;100000] range, otherwise the request is rejected with 406. An undefined md is stored as 0. The response holds the UUIDs of the created topset and tops, top_uuids is not guaranteed to follow the order of the request

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/92cd7c2c-6e67-409a-a8fc-ce2324433ca0/topsets/bulk' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Topset with tops",
  "tops" : [ {
    "name" : "Top 1",
    "md" : {
      "val" : 100.0
    },
    "dip" : {
      "val" : 4.2
    },
    "azimuth" : {
      "val" : 127.3
    },
    "dip_classification" : "bedding",
    "confidence" : {
      "val" : 0.94
    },
    "source" : "ai",
    "model_info" : "WI_BeddingPlane_v2.1"
  }, {
    "name" : "Top 2",
    "md" : {
      "val" : 200.0
    }
  } ]
}'

POST /public/api/v1/typewells/92cd7c2c-6e67-409a-a8fc-ce2324433ca0/topsets/bulk HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 417

{
  "name" : "Topset with tops",
  "tops" : [ {
    "name" : "Top 1",
    "md" : {
      "val" : 100.0
    },
    "dip" : {
      "val" : 4.2
    },
    "azimuth" : {
      "val" : 127.3
    },
    "dip_classification" : "bedding",
    "confidence" : {
      "val" : 0.94
    },
    "source" : "ai",
    "model_info" : "WI_BeddingPlane_v2.1"
  }, {
    "name" : "Top 2",
    "md" : {
      "val" : 200.0
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: d6169ddfa7553f0c415c9901ea8199a4
Content-Type: application/json

{
  "topset_uuid" : "b3630224-eaeb-4da3-bf86-818b2f34c7d0",
  "top_uuids" : [ "52e6c197-fe37-4eff-87d8-005afb8ed637", "0a07ed42-4da0-4555-9f8a-01c5987de337" ]
}

POST /public/api/v1/typewells/{uuid}/topsets/bulk

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Topset name (up to 1000 characters, required)
tops Array Tops to create in the topset, at least one
tops[].name String Top name (up to 1000 characters, required)
tops[].md Object Measured depth (required). If present val is set, otherwise undefined is true
tops[].md.val Number Measured depth value in project units, must be in [0;100000] range, otherwise 406 is returned
tops[].md.undefined Boolean Set to true if MD is undefined, MD is then stored as 0
tops[].dip Object Dip. If present val is set, otherwise undefined is true
tops[].dip.val Number Dip value in degrees, must be in [0;90] range, otherwise 400 is returned
tops[].dip.undefined Boolean Set to true if dip is undefined
tops[].azimuth Object Azimuth. If present val is set, otherwise undefined is true
tops[].azimuth.val Number Azimuth value in degrees, must be in [0;360) range, otherwise 400 is returned
tops[].azimuth.undefined Boolean Set to true if azimuth is undefined
tops[].dip_classification String Dip classification, must be null or one of: bedding, thin_bed, fault, fracture_open, fracture_healed, fracture_induced, otherwise 400 is returned
tops[].confidence Object Confidence. If present val is set, otherwise undefined is true
tops[].confidence.val Number Confidence value, must be in [0;1] range, otherwise 400 is returned
tops[].confidence.undefined Boolean Set to true if confidence is undefined
tops[].source String Top source, must be null or one of: manual, ai, otherwise 400 is returned
tops[].model_info String Model info

Response body

Path Type Description
topset_uuid String Created topset UUID
top_uuids Array UUIDs of the created tops

Create nested well topset with tops

Create a topset together with its tops by nested well UUID in one request. Each top takes the same fields as in Create top, invalid attribute values are rejected with 400. md is in project units and must be in [0;100000] range, otherwise the request is rejected with 406. An undefined md is stored as 0. The response holds the UUIDs of the created topset and tops, top_uuids is not guaranteed to follow the order of the request

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/cc288539-e5e6-4496-a4aa-42bb9d940343/topsets/bulk' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Topset with tops",
  "tops" : [ {
    "name" : "Top 1",
    "md" : {
      "val" : 100.0
    },
    "dip" : {
      "val" : 4.2
    },
    "azimuth" : {
      "val" : 127.3
    },
    "dip_classification" : "bedding",
    "confidence" : {
      "val" : 0.94
    },
    "source" : "ai",
    "model_info" : "WI_BeddingPlane_v2.1"
  }, {
    "name" : "Top 2",
    "md" : {
      "val" : 200.0
    }
  } ]
}'

POST /public/api/v1/nestedwells/cc288539-e5e6-4496-a4aa-42bb9d940343/topsets/bulk HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 417

{
  "name" : "Topset with tops",
  "tops" : [ {
    "name" : "Top 1",
    "md" : {
      "val" : 100.0
    },
    "dip" : {
      "val" : 4.2
    },
    "azimuth" : {
      "val" : 127.3
    },
    "dip_classification" : "bedding",
    "confidence" : {
      "val" : 0.94
    },
    "source" : "ai",
    "model_info" : "WI_BeddingPlane_v2.1"
  }, {
    "name" : "Top 2",
    "md" : {
      "val" : 200.0
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 95f0c837a43ea89a6a05611b2bb04d7a
Content-Type: application/json

{
  "topset_uuid" : "45cd3866-aa99-4769-a78a-0bd5272b23dd",
  "top_uuids" : [ "4efe2486-c8cf-4606-83f3-86b3fdd53545", "a1dc3bb3-5cd4-4f91-8d89-0ae18bc1c7aa" ]
}

POST /public/api/v1/nestedwells/{uuid}/topsets/bulk

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Topset name (up to 1000 characters, required)
tops Array Tops to create in the topset, at least one
tops[].name String Top name (up to 1000 characters, required)
tops[].md Object Measured depth (required). If present val is set, otherwise undefined is true
tops[].md.val Number Measured depth value in project units, must be in [0;100000] range, otherwise 406 is returned
tops[].md.undefined Boolean Set to true if MD is undefined, MD is then stored as 0
tops[].dip Object Dip. If present val is set, otherwise undefined is true
tops[].dip.val Number Dip value in degrees, must be in [0;90] range, otherwise 400 is returned
tops[].dip.undefined Boolean Set to true if dip is undefined
tops[].azimuth Object Azimuth. If present val is set, otherwise undefined is true
tops[].azimuth.val Number Azimuth value in degrees, must be in [0;360) range, otherwise 400 is returned
tops[].azimuth.undefined Boolean Set to true if azimuth is undefined
tops[].dip_classification String Dip classification, must be null or one of: bedding, thin_bed, fault, fracture_open, fracture_healed, fracture_induced, otherwise 400 is returned
tops[].confidence Object Confidence. If present val is set, otherwise undefined is true
tops[].confidence.val Number Confidence value, must be in [0;1] range, otherwise 400 is returned
tops[].confidence.undefined Boolean Set to true if confidence is undefined
tops[].source String Top source, must be null or one of: manual, ai, otherwise 400 is returned
tops[].model_info String Model info

Response body

Path Type Description
topset_uuid String Created topset UUID
top_uuids Array UUIDs of the created tops

Get topsets by lateral

Get a list of topsets by lateral UUID with pagination, sorted by name

Request

$ curl 'https://solo.cloud/public/api/v1/wells/bf615764-66c5-4ffd-b44a-c7a7f216672d/topsets?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/bf615764-66c5-4ffd-b44a-c7a7f216672d/topsets?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 1aa5832be6b7cf60a401887d438ad203
Content-Type: application/json

{
  "content" : [ {
    "name" : "C Log TopSet GyCUlrnLMp",
    "uuid" : "f12e38ed-a726-4970-9403-ddfd66611d33"
  }, {
    "name" : "D Well DVZiBCBVDs",
    "uuid" : "6ef7880c-9751-492e-99d0-fef6ba34a994"
  }, {
    "name" : "Top Set",
    "uuid" : "acd9ca45-1d72-417c-8ad3-f0337d203a54"
  }, {
    "name" : "TopSet Log vRicYyNvKH",
    "uuid" : "d1bf8c61-bcb5-48cd-a21c-e132b752bed9"
  }, {
    "name" : "TopSetXKtfieCRxB",
    "uuid" : "a3d6ab42-b519-4103-992f-2c95bb9091d2"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 5,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/topsets

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Topset name
content[].uuid String Topset UUID

Get topsets by typewell

Get a list of topsets by typewell UUID with pagination, sorted by name

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/92cd7c2c-6e67-409a-a8fc-ce2324433ca0/topsets?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/92cd7c2c-6e67-409a-a8fc-ce2324433ca0/topsets?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f532561eede0f5b1e6ffb6bf857faa95
Content-Type: application/json

{
  "content" : [ {
    "name" : "C Log TopSet ASaaloBRFU",
    "uuid" : "32432c4b-53ee-4998-bb76-57feddf5032d"
  }, {
    "name" : "D Well EWTAVITsEW",
    "uuid" : "6f320dbd-a042-4423-bd87-ecb96df03f65"
  }, {
    "name" : "TopSet Log dxTRDmqWkZ",
    "uuid" : "49f1e617-db51-450f-8b4f-40f27d67291e"
  }, {
    "name" : "TopSetPryixJDlBg",
    "uuid" : "3b679f02-364d-4438-a398-0bbc713c40c5"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 4,
  "first" : true,
  "last" : true
}

GET /public/api/v1/typewells/{uuid}/topsets

Path parameter Description
uuid Typewell UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Topset name
content[].uuid String Topset UUID

Get topsets by nested well

Get a list of topsets by nested well UUID with pagination, sorted by name

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/cc288539-e5e6-4496-a4aa-42bb9d940343/topsets?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/nestedwells/cc288539-e5e6-4496-a4aa-42bb9d940343/topsets?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 399e8afc121a72f71d9d8910e1640073
Content-Type: application/json

{
  "content" : [ {
    "name" : "C Log TopSet XljKbCHAWc",
    "uuid" : "a890fa69-8d7b-4f41-8ebe-444879008dea"
  }, {
    "name" : "D Well uvqzOeVBoG",
    "uuid" : "567b6994-ee37-4a38-8de4-2a285d01db28"
  }, {
    "name" : "TopSet Log GpWgLrbiWe",
    "uuid" : "08bd176c-3f05-4c17-8856-b16846d0e824"
  }, {
    "name" : "Topset name",
    "uuid" : "17abc676-6d1d-4ff6-85fe-fe36e7c05d9a"
  }, {
    "name" : "Topset with tops",
    "uuid" : "45cd3866-aa99-4769-a78a-0bd5272b23dd"
  }, {
    "name" : "TopSetzJoqsYkhEK",
    "uuid" : "cce2c28e-7efc-4f13-aec2-f784a3af985e"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 6,
  "first" : true,
  "last" : true
}

GET /public/api/v1/nestedwells/{uuid}/topsets

Path parameter Description
uuid Nested well UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Topset name
content[].uuid String Topset UUID

Get zones by topset

Get a list of zones by topset UUID with pagination, sorted by name

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/65610244-765d-4097-8a43-1715c9606d76/zones?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/topsets/65610244-765d-4097-8a43-1715c9606d76/zones?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 8f81444d3b4fb450a75b1e06320f66c1
Content-Type: application/json

{
  "content" : [ {
    "name" : "zone1",
    "top_start" : "start",
    "top_end" : "end",
    "zone_id" : "7bb13e6d-b214-4cc4-a383-009dfb625e6d"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/topsets/{uuid}/zones

Path parameter Description
uuid Topset UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].zone_id String Zone UUID
content[].name String Zone name
content[].top_start String Name of the zone start top
content[].top_end String Name of the zone end top
content[].from_tvd_offset Object TVD offset of the zone start in meters, not converted to project units. If present val is set, otherwise undefined is true
content[].to_tvd_offset Object TVD offset of the zone end in meters, not converted to project units. If present val is set, otherwise undefined is true

Get starred objects

Get the starred top, center and bottom tops by topset UUID. A position that is not set, or whose top was deleted, is omitted from the response

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/acd9ca45-1d72-417c-8ad3-f0337d203a54/starred' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/topsets/acd9ca45-1d72-417c-8ad3-f0337d203a54/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: cd37bef4a39b752f54514f15977c3ad0
Content-Type: application/json

{
  "top" : "d7638b43-ccb9-4818-ab90-251c0b23466e",
  "center" : "c8d2a4c1-01fc-4ec3-aa49-4045c196e2e6",
  "bottom" : "dc13a4c7-9c3e-4725-8614-5fee835031e0"
}

GET /public/api/v1/topsets/{uuid}/starred

Path parameter Description
uuid Topset UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
top String UUID of the starred top, absent when not set or when the top no longer exists
center String UUID of the starred center top, absent when not set or when the top no longer exists
bottom String UUID of the starred bottom top, absent when not set or when the top no longer exists

Set starred objects

Set the starred top, center and bottom tops by topset UUID. All three fields are required and replace the current values. Each value must be a top of this topset, or 00000000-0000-0000-0000-000000000000 to reset the position. One top cannot be starred in two positions. A request that breaks these rules is rejected with 400. A private topset of another user is rejected with 403

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/acd9ca45-1d72-417c-8ad3-f0337d203a54/starred' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "top" : "d7638b43-ccb9-4818-ab90-251c0b23466e",
  "center" : "c8d2a4c1-01fc-4ec3-aa49-4045c196e2e6",
  "bottom" : "dc13a4c7-9c3e-4725-8614-5fee835031e0"
}'

PUT /public/api/v1/topsets/acd9ca45-1d72-417c-8ad3-f0337d203a54/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 158

{
  "top" : "d7638b43-ccb9-4818-ab90-251c0b23466e",
  "center" : "c8d2a4c1-01fc-4ec3-aa49-4045c196e2e6",
  "bottom" : "dc13a4c7-9c3e-4725-8614-5fee835031e0"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: bdae3860a8951cee4622fa589fda5a27

PUT /public/api/v1/topsets/{uuid}/starred

Path parameter Description
uuid Topset UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
top String UUID of a top of this topset to be set as starred top (use "00000000-0000-0000-0000-000000000000" to reset)
center String UUID of a top of this topset to be set as starred center (use "00000000-0000-0000-0000-000000000000" to reset)
bottom String UUID of a top of this topset to be set as starred bottom (use "00000000-0000-0000-0000-000000000000" to reset)

Response body

Empty body

Update topset

Update topset name by UUID. Returns 403 if the topset is locked or is a private topset of another user

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/acd9ca45-1d72-417c-8ad3-f0337d203a54' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "New topset name"
}'

PATCH /public/api/v1/topsets/acd9ca45-1d72-417c-8ad3-f0337d203a54 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 32

{
  "name" : "New topset name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 4c9085e15613c2999ac051aa25ca0d87

PATCH /public/api/v1/topsets/{uuid}

Path parameter Description
uuid Topset UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Topset name (up to 1000 characters)

Response body

Empty body

Lock topset

Lock topset by UUID. A locked topset cannot be renamed or deleted, and its tops cannot be created, updated or deleted (403) until it is unlocked. A private topset cannot be locked (403). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/8f161718-212b-423c-b4b2-57a3ed751b78/lock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/topsets/8f161718-212b-423c-b4b2-57a3ed751b78/lock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 66f0ff81bff4e6bc1aac81ff93f3aa23

PATCH /public/api/v1/topsets/{uuid}/lock

Path parameter Description
uuid Topset UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Unlock topset

Unlock topset by UUID. A private topset cannot be unlocked (403). Requires the permission to lock objects

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/65610244-765d-4097-8a43-1715c9606d76/unlock' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>'

PATCH /public/api/v1/topsets/65610244-765d-4097-8a43-1715c9606d76/unlock HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 9f1d4989e2b1b67c7f7be3fce00d91e6

PATCH /public/api/v1/topsets/{uuid}/unlock

Path parameter Description
uuid Topset UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Delete topset

Delete topset by UUID together with its tops and zones. Returns 403 if the topset is locked or is a private topset of another user

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/acd9ca45-1d72-417c-8ad3-f0337d203a54' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/topsets/acd9ca45-1d72-417c-8ad3-f0337d203a54 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: a0211041386024dcf371e9eb9ccbcd78

DELETE /public/api/v1/topsets/{uuid}

Path parameter Description
uuid Topset UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

8. Tops

Create top

Create top by topset UUID. Returns 403 if the topset is locked or is a private topset of another user

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/34ea974d-dbd9-475a-be30-d1d847f3b251/tops' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Top name",
  "md" : {
    "val" : 100.5
  },
  "dip" : {
    "val" : 45.0
  },
  "azimuth" : {
    "val" : 180.0
  },
  "dip_classification" : "bedding",
  "confidence" : {
    "val" : 0.95
  },
  "source" : "manual",
  "model_info" : "human"
}'

POST /public/api/v1/topsets/34ea974d-dbd9-475a-be30-d1d847f3b251/tops HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 258

{
  "name" : "Top name",
  "md" : {
    "val" : 100.5
  },
  "dip" : {
    "val" : 45.0
  },
  "azimuth" : {
    "val" : 180.0
  },
  "dip_classification" : "bedding",
  "confidence" : {
    "val" : 0.95
  },
  "source" : "manual",
  "model_info" : "human"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 89c294578a6cc16b90c7e5221eb08be2
Content-Type: application/json

{
  "uuid" : "0ffff7b6-fc27-4be0-aa94-835d7b320e49"
}

POST /public/api/v1/topsets/{uuid}/tops

Path parameter Description
uuid Topset UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Top name (up to 1000 characters, required on create)
md Object Measured depth (required on create). If present val is set, otherwise undefined is true
md.val Number Measured depth value in project units, must be in [0;100000] range, otherwise 406 is returned
md.undefined Boolean Set to true if MD is undefined, MD is then stored as 0
dip Object Dip. If present val is set, otherwise undefined is true
dip.val Number Dip value in degrees, must be in [0;90] range, otherwise 400 is returned
dip.undefined Boolean Set to true if dip is undefined
azimuth Object Azimuth. If present val is set, otherwise undefined is true
azimuth.val Number Azimuth value in degrees, must be in [0;360) range, otherwise 400 is returned
azimuth.undefined Boolean Set to true if azimuth is undefined
dip_classification String Dip classification, must be null or one of: bedding, thin_bed, fault, fracture_open, fracture_healed, fracture_induced, otherwise 400 is returned
confidence Object Confidence. If present val is set, otherwise undefined is true
confidence.val Number Confidence value, must be in [0;1] range, otherwise 400 is returned
confidence.undefined Boolean Set to true if confidence is undefined
source String Top source, must be null or one of: manual, ai, otherwise 400 is returned
model_info String Model info

Response body

Path Type Description
uuid String Created top UUID

Get tops by topset

Get a list of tops by topset UUID with pagination, in creation order

Request

$ curl 'https://solo.cloud/public/api/v1/topsets/d2b61741-bf63-489d-9a04-954be17eb0ba/tops?offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/topsets/d2b61741-bf63-489d-9a04-954be17eb0ba/tops?offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e02bd768af7776e7f225ed2ed6106468
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "f321222b-c6cf-4e8d-b5af-c4ee173e211a",
    "name" : "Top",
    "topset_name" : "Top Set",
    "md" : {
      "val" : 9.84251968503937
    },
    "dip" : {
      "val" : 114.59155902616465
    },
    "azimuth" : {
      "val" : 57.29577951308232
    },
    "dip_classification" : "dip classification",
    "confidence" : {
      "val" : 0.5
    },
    "source" : "source",
    "model_info" : "model info"
  }, {
    "uuid" : "2e359e9e-b5d0-4dbb-892d-9cffc897aa25",
    "name" : "Update Top",
    "topset_name" : "Top Set",
    "md" : {
      "val" : 13.123359580052492
    },
    "dip" : {
      "val" : 171.88733853924697
    },
    "azimuth" : {
      "val" : 114.59155902616465
    },
    "dip_classification" : "update dip classification",
    "confidence" : {
      "val" : 0.5
    },
    "source" : "update source",
    "model_info" : "update model info"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/topsets/{uuid}/tops

Path parameter Description
uuid Topset UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Top UUID
content[].name String Top name
content[].topset_name String Topset name
content[].md.val Number Measured depth value in project units
content[].dip.val Number Dip value in degrees
content[].azimuth.val Number Azimuth value in degrees
content[].dip_classification String Dip classification
content[].confidence.val Number Confidence value
content[].source String Top source (manual when not set)
content[].model_info String Model info

Get tops by lateral

Get a list of tops of all lateral topsets by lateral UUID with pagination, in creation order

Request

$ curl 'https://solo.cloud/public/api/v1/wells/462f7e1d-5ba1-4ea2-8ee2-2059f1a0f20a/tops?offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/462f7e1d-5ba1-4ea2-8ee2-2059f1a0f20a/tops?offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 28aca44929eb25f67d0392b1a4c0d3c9
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "e4b44f3b-d41c-4bc8-abc1-1c08329eb8b8",
    "name" : "Top",
    "topset_name" : "Top Set",
    "md" : {
      "val" : 9.84251968503937
    },
    "dip" : {
      "val" : 114.59155902616465
    },
    "azimuth" : {
      "val" : 57.29577951308232
    },
    "dip_classification" : "dip classification",
    "confidence" : {
      "val" : 0.5
    },
    "source" : "source",
    "model_info" : "model info"
  }, {
    "uuid" : "a3bfd027-f47c-45bf-8d5f-f7e9225cb41a",
    "name" : "Update Top",
    "topset_name" : "Top Set",
    "md" : {
      "val" : 13.123359580052492
    },
    "dip" : {
      "val" : 171.88733853924697
    },
    "azimuth" : {
      "val" : 114.59155902616465
    },
    "dip_classification" : "update dip classification",
    "confidence" : {
      "val" : 0.5
    },
    "source" : "update source",
    "model_info" : "update model info"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/tops

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Top UUID
content[].name String Top name
content[].topset_name String Topset name
content[].md.val Number Measured depth value in project units
content[].dip.val Number Dip value in degrees
content[].azimuth.val Number Azimuth value in degrees
content[].dip_classification String Dip classification
content[].confidence.val Number Confidence value
content[].source String Top source (manual when not set)
content[].model_info String Model info

Get tops by typewell

Get a list of tops of all typewell topsets by typewell UUID with pagination, in creation order

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/2443b693-3018-4e1d-81c6-85e0367d6482/tops?offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/2443b693-3018-4e1d-81c6-85e0367d6482/tops?offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: a3bea4ea72efc2151d772fb280386958
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "14ddc65e-06e3-4992-8477-9f6c5f01db6f",
    "name" : "Top",
    "topset_name" : "Top Set",
    "md" : {
      "val" : 9.84251968503937
    },
    "dip" : {
      "val" : 114.59155902616465
    },
    "azimuth" : {
      "val" : 57.29577951308232
    },
    "dip_classification" : "dip classification",
    "confidence" : {
      "val" : 0.5
    },
    "source" : "source",
    "model_info" : "model info"
  }, {
    "uuid" : "5f91f43a-b291-4c24-b949-e9122fb0edf4",
    "name" : "Update Top",
    "topset_name" : "Top Set",
    "md" : {
      "val" : 13.123359580052492
    },
    "dip" : {
      "val" : 171.88733853924697
    },
    "azimuth" : {
      "val" : 114.59155902616465
    },
    "dip_classification" : "update dip classification",
    "confidence" : {
      "val" : 0.5
    },
    "source" : "update source",
    "model_info" : "update model info"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/typewells/{uuid}/tops

Path parameter Description
uuid Typewell UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Top UUID
content[].name String Top name
content[].topset_name String Topset name
content[].md.val Number Measured depth value in project units
content[].dip.val Number Dip value in degrees
content[].azimuth.val Number Azimuth value in degrees
content[].dip_classification String Dip classification
content[].confidence.val Number Confidence value
content[].source String Top source (manual when not set)
content[].model_info String Model info

Get tops by nested well

Get a list of tops of all nested well topsets by nested well UUID with pagination, in creation order

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/3b61ee70-fbcd-4cc0-a358-f8023945df22/tops?offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/nestedwells/3b61ee70-fbcd-4cc0-a358-f8023945df22/tops?offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 50356b0418e99e14b64e14ffe0ee3c4c
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "20d1be5f-1010-491b-80d7-e2f42118fbed",
    "name" : "Top",
    "topset_name" : "Top Set",
    "md" : {
      "val" : 9.84251968503937
    },
    "dip" : {
      "val" : 114.59155902616465
    },
    "azimuth" : {
      "val" : 57.29577951308232
    },
    "dip_classification" : "dip classification",
    "confidence" : {
      "val" : 0.5
    },
    "source" : "source",
    "model_info" : "model info"
  }, {
    "uuid" : "8693c1e4-8bae-4ba5-8998-9883cdd6e1ef",
    "name" : "Update Top",
    "topset_name" : "Top Set",
    "md" : {
      "val" : 13.123359580052492
    },
    "dip" : {
      "val" : 171.88733853924697
    },
    "azimuth" : {
      "val" : 114.59155902616465
    },
    "dip_classification" : "update dip classification",
    "confidence" : {
      "val" : 0.5
    },
    "source" : "update source",
    "model_info" : "update model info"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/nestedwells/{uuid}/tops

Path parameter Description
uuid Nested well UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Top UUID
content[].name String Top name
content[].topset_name String Topset name
content[].md.val Number Measured depth value in project units
content[].dip.val Number Dip value in degrees
content[].azimuth.val Number Azimuth value in degrees
content[].dip_classification String Dip classification
content[].confidence.val Number Confidence value
content[].source String Top source (manual when not set)
content[].model_info String Model info

Update top

Update top by UUID. Omitted or null fields keep their current values. Returns 403 if the topset is locked or is a private topset of another user

Request

$ curl 'https://solo.cloud/public/api/v1/tops/a3bfd027-f47c-45bf-8d5f-f7e9225cb41a' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "New top name",
  "md" : {
    "val" : 999.5
  },
  "dip" : {
    "val" : 90.0
  },
  "azimuth" : {
    "val" : 359.999
  },
  "dip_classification" : "thin_bed",
  "confidence" : {
    "val" : 0.98
  },
  "source" : "ai",
  "model_info" : "model-v1"
}'

PATCH /public/api/v1/tops/a3bfd027-f47c-45bf-8d5f-f7e9225cb41a HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 264

{
  "name" : "New top name",
  "md" : {
    "val" : 999.5
  },
  "dip" : {
    "val" : 90.0
  },
  "azimuth" : {
    "val" : 359.999
  },
  "dip_classification" : "thin_bed",
  "confidence" : {
    "val" : 0.98
  },
  "source" : "ai",
  "model_info" : "model-v1"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 72f1070d0bde8e85ecc80ff4dbacb6ae

PATCH /public/api/v1/tops/{uuid}

Path parameter Description
uuid Top UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Top name (up to 1000 characters, required on create)
md Object Measured depth (required on create). If present val is set, otherwise undefined is true
md.val Number Measured depth value in project units, must be in [0;100000] range, otherwise 406 is returned
md.undefined Boolean Set to true if MD is undefined, MD is then stored as 0
dip Object Dip. If present val is set, otherwise undefined is true
dip.val Number Dip value in degrees, must be in [0;90] range, otherwise 400 is returned
dip.undefined Boolean Set to true if dip is undefined
azimuth Object Azimuth. If present val is set, otherwise undefined is true
azimuth.val Number Azimuth value in degrees, must be in [0;360) range, otherwise 400 is returned
azimuth.undefined Boolean Set to true if azimuth is undefined
dip_classification String Dip classification, must be null or one of: bedding, thin_bed, fault, fracture_open, fracture_healed, fracture_induced, otherwise 400 is returned
confidence Object Confidence. If present val is set, otherwise undefined is true
confidence.val Number Confidence value, must be in [0;1] range, otherwise 400 is returned
confidence.undefined Boolean Set to true if confidence is undefined
source String Top source, must be null or one of: manual, ai, otherwise 400 is returned
model_info String Model info

Response body

Empty body

Delete top

Delete top by UUID. Returns 403 if the topset is locked or is a private topset of another user

Request

$ curl 'https://solo.cloud/public/api/v1/tops/a3bfd027-f47c-45bf-8d5f-f7e9225cb41a' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/tops/a3bfd027-f47c-45bf-8d5f-f7e9225cb41a HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e7876d2cacf4c946f3d4da9b6dbaab07

DELETE /public/api/v1/tops/{uuid}

Path parameter Description
uuid Top UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

9. Target lines

Create target line

Create target line from origin and target points by lateral UUID. All fields are required, all coordinates must be defined. A missing field returns 400, an undefined coordinate 406

Request

$ curl 'https://solo.cloud/public/api/v1/wells/214897ab-64dc-4366-ae8d-45bf42b0270f/targetlines' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Target line name",
  "origin_x" : {
    "val" : 100.5
  },
  "origin_y" : {
    "val" : 200.5
  },
  "origin_z" : {
    "val" : 300.5
  },
  "target_x" : {
    "val" : 400.5
  },
  "target_y" : {
    "val" : 500.5
  },
  "target_z" : {
    "val" : 600.5
  }
}'

POST /public/api/v1/wells/214897ab-64dc-4366-ae8d-45bf42b0270f/targetlines HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 273

{
  "name" : "Target line name",
  "origin_x" : {
    "val" : 100.5
  },
  "origin_y" : {
    "val" : 200.5
  },
  "origin_z" : {
    "val" : 300.5
  },
  "target_x" : {
    "val" : 400.5
  },
  "target_y" : {
    "val" : 500.5
  },
  "target_z" : {
    "val" : 600.5
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 538658a91ab7b96394ff22a2f34361cb
Content-Type: application/json

{
  "uuid" : "eaab784f-2222-41b3-9f82-d8a5254c74f1"
}

POST /public/api/v1/wells/{uuid}/targetlines

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Target line name (up to 1000 characters)
origin_x.val Number Origin point X coordinate (project units)
origin_y.val Number Origin point Y coordinate (project units)
origin_z.val Number Origin point Z coordinate (project units)
target_x.val Number Target point X coordinate (project units)
target_y.val Number Target point Y coordinate (project units)
target_z.val Number Target point Z coordinate (project units)

Response body

Path Type Description
uuid String Created target line UUID

Create target line from waypoints

Create target line from waypoints by lateral UUID. At least two waypoints with defined coordinates and unique order values are required. A missing field returns 400, an undefined coordinate 406, fewer than two waypoints or duplicate order values return 400

Request

$ curl 'https://solo.cloud/public/api/v1/wells/d94b642e-bd05-4342-9dd9-6215b6366989/targetlines/fromwaypoints' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Target line name",
  "waypoints" : [ {
    "name" : "Waypoint1",
    "break" : false,
    "order" : 2,
    "x" : {
      "val" : 30.0
    },
    "y" : {
      "val" : 10.0
    },
    "z" : {
      "val" : 40.0
    }
  }, {
    "name" : "Waypoint2",
    "break" : false,
    "order" : 3,
    "x" : {
      "val" : 70.0
    },
    "y" : {
      "val" : 80.0
    },
    "z" : {
      "val" : 90.0
    }
  } ]
}'

POST /public/api/v1/wells/d94b642e-bd05-4342-9dd9-6215b6366989/targetlines/fromwaypoints HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 421

{
  "name" : "Target line name",
  "waypoints" : [ {
    "name" : "Waypoint1",
    "break" : false,
    "order" : 2,
    "x" : {
      "val" : 30.0
    },
    "y" : {
      "val" : 10.0
    },
    "z" : {
      "val" : 40.0
    }
  }, {
    "name" : "Waypoint2",
    "break" : false,
    "order" : 3,
    "x" : {
      "val" : 70.0
    },
    "y" : {
      "val" : 80.0
    },
    "z" : {
      "val" : 90.0
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 13469d95b9e08580c5292571872106b0
Content-Type: application/json

{
  "uuid" : "21a87449-d5ed-408c-8452-43e803125267"
}

POST /public/api/v1/wells/{uuid}/targetlines/fromwaypoints

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Target line name (up to 1000 characters)
waypoints Array Target line waypoints, at least two
waypoints[].name String Waypoint name (up to 200 characters). Get target lines by lateral returns generated names instead
waypoints[].order Number Waypoint order: waypoints are sorted by it, values must be unique
waypoints[].x.val Number Waypoint X coordinate (project units)
waypoints[].y.val Number Waypoint Y coordinate (project units)
waypoints[].z.val Number Waypoint Z coordinate (project units)
waypoints[].break Boolean Is the waypoint break point or not

Response body

Path Type Description
uuid String Created target line UUID

Get target lines by lateral

Get a list of target lines with their waypoints by lateral UUID with pagination, in creation order. Waypoints are returned sorted by order, renumbered from 0 and named Origin, WP1, WP2, ..., Target

Request

$ curl 'https://solo.cloud/public/api/v1/wells/e6ec856f-2d05-4393-96a4-edafa96f60e5/targetlines?offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/e6ec856f-2d05-4393-96a4-edafa96f60e5/targetlines?offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 341ca3c69e3be71b2e7bf834eeb60d4d
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "d6df9b27-0c6e-47f3-a86d-961b9847b66b",
    "name" : "Target Line",
    "waypoints" : [ {
      "name" : "Origin",
      "order" : 0,
      "x" : {
        "val" : 3.280839895013123
      },
      "y" : {
        "val" : 6.561679790026246
      },
      "z" : {
        "val" : 9.84251968503937
      },
      "top_corridor_tvd" : {
        "undefined" : true
      },
      "base_corridor_tvd" : {
        "undefined" : true
      },
      "left_corridor" : {
        "undefined" : true
      },
      "right_corridor" : {
        "undefined" : true
      },
      "break" : false
    }, {
      "name" : "Target",
      "order" : 1,
      "x" : {
        "val" : 13.123359580052492
      },
      "y" : {
        "val" : 16.404199475065617
      },
      "z" : {
        "val" : 19.68503937007874
      },
      "top_corridor_tvd" : {
        "val" : 25.0
      },
      "base_corridor_tvd" : {
        "val" : 25.0
      },
      "left_corridor" : {
        "val" : 25.0
      },
      "right_corridor" : {
        "val" : 25.0
      },
      "break" : false
    } ]
  }, {
    "uuid" : "6a207cfc-664d-4888-835e-10eb66ba466b",
    "name" : "Update Target Line",
    "waypoints" : [ {
      "name" : "Origin",
      "order" : 0,
      "x" : {
        "val" : 36.41732283464567
      },
      "y" : {
        "val" : 39.69816272965879
      },
      "z" : {
        "val" : 42.979002624671914
      },
      "top_corridor_tvd" : {
        "undefined" : true
      },
      "base_corridor_tvd" : {
        "undefined" : true
      },
      "left_corridor" : {
        "undefined" : true
      },
      "right_corridor" : {
        "undefined" : true
      },
      "break" : false
    }, {
      "name" : "Target",
      "order" : 1,
      "x" : {
        "val" : 46.25984251968504
      },
      "y" : {
        "val" : 49.54068241469816
      },
      "z" : {
        "val" : 52.82152230971129
      },
      "top_corridor_tvd" : {
        "val" : 28.608923884514432
      },
      "base_corridor_tvd" : {
        "val" : 28.608923884514432
      },
      "left_corridor" : {
        "val" : 25.0
      },
      "right_corridor" : {
        "val" : 25.0
      },
      "break" : false
    } ]
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/targetlines

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Target line UUID
content[].name String Target line name
content[].waypoints Array Target line waypoints sorted by order
content[].waypoints[].name String Waypoint name: Origin for the first waypoint, Target for the last one, WP1, WP2, ... for the others
content[].waypoints[].order Number Zero-based index of the waypoint in the list
content[].waypoints[].x.val Number Waypoint X coordinate (project units)
content[].waypoints[].y.val Number Waypoint Y coordinate (project units)
content[].waypoints[].z.val Number Waypoint Z coordinate (project units)
content[].waypoints[].top_corridor_tvd Object Waypoint top corridor: vertical distance above the target line. If present val is set, otherwise undefined is true (always for the first waypoint)
content[].waypoints[].top_corridor_tvd.val Number Waypoint top corridor value (project units)
content[].waypoints[].base_corridor_tvd Object Waypoint base corridor: vertical distance below the target line. If present val is set, otherwise undefined is true (always for the first waypoint)
content[].waypoints[].base_corridor_tvd.val Number Waypoint base corridor value (project units)
content[].waypoints[].left_corridor Object Waypoint left corridor width. If present val is set, otherwise undefined is true (always for the first waypoint)
content[].waypoints[].left_corridor.val Number Waypoint left corridor value (project units)
content[].waypoints[].right_corridor Object Waypoint right corridor width. If present val is set, otherwise undefined is true (always for the first waypoint)
content[].waypoints[].right_corridor.val Number Waypoint right corridor value (project units)
content[].waypoints[].break Boolean Is the waypoint break point or not

Get target line data

Get calculated data of a target line by target line UUID. The content array holds one element

Request

$ curl 'https://solo.cloud/public/api/v1/targetlines/d843489c-fd91-42b5-bb8d-62566517a297/data' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/targetlines/d843489c-fd91-42b5-bb8d-62566517a297/data HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3ecde4b81e75bd8c87f879a5e5207e7d
Content-Type: application/json

{
  "content" : [ {
    "azimuth" : {
      "val" : 45
    },
    "delta_tvd" : {
      "val" : -9.842519685039372
    },
    "delta_vs" : {
      "val" : 9.842519685039374
    },
    "inclination" : {
      "val" : 125.26438968275465
    },
    "length" : {
      "val" : 17.047744168985016
    },
    "name" : "Target Line",
    "origin_base_corridor_tvd" : {
      "val" : 38.1233595800525
    },
    "origin_md" : {
      "val" : 1594.0953719875106
    },
    "origin_top_corridor_tvd" : {
      "val" : -11.876640419947508
    },
    "origin_tvd" : {
      "val" : 13.123359580052496
    },
    "origin_vs" : {
      "val" : -26.246719160104988
    },
    "origin_x" : {
      "val" : 3.280839895013124
    },
    "origin_y" : {
      "val" : 6.561679790026248
    },
    "origin_z" : {
      "val" : 9.842519685039372
    },
    "target_base_corridor_tvd" : {
      "val" : 28.280839895013127
    },
    "target_md" : {
      "val" : 1106.7125786029799
    },
    "target_top_corridor_tvd" : {
      "val" : -21.71916010498688
    },
    "target_tvd" : {
      "val" : 3.2808398950131235
    },
    "target_vs" : {
      "val" : -16.404199475065614
    },
    "target_x" : {
      "val" : 13.123359580052496
    },
    "target_y" : {
      "val" : 16.40419947506562
    },
    "target_z" : {
      "val" : 19.685039370078744
    },
    "tvd_vs" : {
      "val" : -13.123359580052487
    },
    "uuid" : "d843489c-fd91-42b5-bb8d-62566517a297"
  } ]
}

GET /public/api/v1/targetlines/{uuid}/data

Path parameter Description
uuid Target line UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content[].name String Target line name
content[].uuid String Target line UUID
content[].azimuth.val Number Azimuth (degrees)
content[].inclination.val Number Inclination (degrees)
content[].length.val Number Length (project units)
content[].delta_tvd.val Number Target TVD minus origin TVD (project units)
content[].delta_vs.val Number Target VS minus origin VS (project units)
content[].tvd_vs.val Number TVD of the target line at zero VS (TVD@0VS)
content[].origin_vs.val Number Origin point VS (project units)
content[].origin_tvd.val Number Origin point TVD (project units)
content[].origin_x.val Number Origin point X coordinate (project units)
content[].origin_y.val Number Origin point Y coordinate (project units)
content[].origin_z.val Number Origin point Z coordinate (project units)
content[].origin_md Object Origin MD value. If target line belongs to trajectory val is set, otherwise undefined is true
content[].origin_md.val Number Origin MD value (project units)
content[].origin_md.undefined Boolean true if origin MD undefined
content[].origin_base_corridor_tvd Object Base corridor origin TVD. If present val is set, otherwise undefined is true
content[].origin_base_corridor_tvd.val Number Base corridor origin TVD value (project units)
content[].origin_base_corridor_tvd.undefined Boolean true if base corridor origin is undefined
content[].origin_top_corridor_tvd Object Top corridor origin TVD. If present val is set, otherwise undefined is true
content[].origin_top_corridor_tvd.val Number Top corridor origin TVD (project units)
content[].origin_top_corridor_tvd.undefined Boolean true if top TVD corridor is undefined
content[].target_vs.val Number Target point VS (project units)
content[].target_tvd.val Number Target point TVD (project units)
content[].target_x.val Number Target point X coordinate (project units)
content[].target_y.val Number Target point Y coordinate (project units)
content[].target_z.val Number Target point Z coordinate (project units)
content[].target_md Object Target MD. If target line belongs to trajectory val is set, otherwise undefined is true
content[].target_md.val Number Target MD value (project units)
content[].target_md.undefined Boolean true if target MD is undefined
content[].target_base_corridor_tvd Object Base corridor target TVD. If present val is set, otherwise undefined is true
content[].target_base_corridor_tvd.val Number Base corridor target TVD (project units)
content[].target_base_corridor_tvd.undefined Boolean true if base corridor target TVD is undefined
content[].target_top_corridor_tvd Object Top corridor target TVD. If present val is set, otherwise undefined is true
content[].target_top_corridor_tvd.val Number Top corridor target TVD (project units)
content[].target_top_corridor_tvd.undefined Boolean true if top corridor target TVD is undefined

Get target lines data by lateral

Get calculated data of all lateral target lines by lateral UUID with pagination, sorted by target line name

Request

$ curl 'https://solo.cloud/public/api/v1/wells/b03be2ff-e3fa-4317-8361-e567d1865976/targetlines/data?offset=0&limit=20' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/b03be2ff-e3fa-4317-8361-e567d1865976/targetlines/data?offset=0&limit=20 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 7cc2b220c47576083b26fb9025739ef0
Content-Type: application/json

{
  "content" : [ {
    "azimuth" : {
      "val" : 45
    },
    "delta_tvd" : {
      "val" : -9.842519685039372
    },
    "delta_vs" : {
      "val" : 9.842519685039374
    },
    "inclination" : {
      "val" : 125.26438968275465
    },
    "length" : {
      "val" : 17.047744168985016
    },
    "name" : "Target Line",
    "origin_base_corridor_tvd" : {
      "val" : 38.1233595800525
    },
    "origin_md" : {
      "val" : 1594.0953719875106
    },
    "origin_top_corridor_tvd" : {
      "val" : -11.876640419947508
    },
    "origin_tvd" : {
      "val" : 13.123359580052496
    },
    "origin_vs" : {
      "val" : -26.246719160104988
    },
    "origin_x" : {
      "val" : 3.280839895013124
    },
    "origin_y" : {
      "val" : 6.561679790026248
    },
    "origin_z" : {
      "val" : 9.842519685039372
    },
    "target_base_corridor_tvd" : {
      "val" : 28.280839895013127
    },
    "target_md" : {
      "val" : 1106.7125786029799
    },
    "target_top_corridor_tvd" : {
      "val" : -21.71916010498688
    },
    "target_tvd" : {
      "val" : 3.2808398950131235
    },
    "target_vs" : {
      "val" : -16.404199475065614
    },
    "target_x" : {
      "val" : 13.123359580052496
    },
    "target_y" : {
      "val" : 16.40419947506562
    },
    "target_z" : {
      "val" : 19.685039370078744
    },
    "tvd_vs" : {
      "val" : -13.123359580052487
    },
    "uuid" : "14ef202e-6dd4-4e90-9d3e-e434faceef1b"
  } ],
  "offset" : 0,
  "limit" : 20,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/targetlines/data

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Target line name
content[].uuid String Target line UUID
content[].azimuth.val Number Azimuth (degrees)
content[].inclination.val Number Inclination (degrees)
content[].length.val Number Length (project units)
content[].delta_tvd.val Number Target TVD minus origin TVD (project units)
content[].delta_vs.val Number Target VS minus origin VS (project units)
content[].tvd_vs.val Number TVD of the target line at zero VS (TVD@0VS)
content[].origin_vs.val Number Origin point VS (project units)
content[].origin_tvd.val Number Origin point TVD (project units)
content[].origin_x.val Number Origin point X coordinate (project units)
content[].origin_y.val Number Origin point Y coordinate (project units)
content[].origin_z.val Number Origin point Z coordinate (project units)
content[].origin_md Object Origin MD value. If target line belongs to trajectory val is set, otherwise undefined is true
content[].origin_md.val Number Origin MD value (project units)
content[].origin_md.undefined Boolean true if origin MD undefined
content[].origin_base_corridor_tvd Object Base corridor origin TVD. If present val is set, otherwise undefined is true
content[].origin_base_corridor_tvd.val Number Base corridor origin TVD value (project units)
content[].origin_base_corridor_tvd.undefined Boolean true if base corridor origin is undefined
content[].origin_top_corridor_tvd Object Top corridor origin TVD. If present val is set, otherwise undefined is true
content[].origin_top_corridor_tvd.val Number Top corridor origin TVD (project units)
content[].origin_top_corridor_tvd.undefined Boolean true if top TVD corridor is undefined
content[].target_vs.val Number Target point VS (project units)
content[].target_tvd.val Number Target point TVD (project units)
content[].target_x.val Number Target point X coordinate (project units)
content[].target_y.val Number Target point Y coordinate (project units)
content[].target_z.val Number Target point Z coordinate (project units)
content[].target_md Object Target MD. If target line belongs to trajectory val is set, otherwise undefined is true
content[].target_md.val Number Target MD value (project units)
content[].target_md.undefined Boolean true if target MD is undefined
content[].target_base_corridor_tvd Object Base corridor target TVD. If present val is set, otherwise undefined is true
content[].target_base_corridor_tvd.val Number Base corridor target TVD (project units)
content[].target_base_corridor_tvd.undefined Boolean true if base corridor target TVD is undefined
content[].target_top_corridor_tvd Object Top corridor target TVD. If present val is set, otherwise undefined is true
content[].target_top_corridor_tvd.val Number Top corridor target TVD (project units)
content[].target_top_corridor_tvd.undefined Boolean true if top corridor target TVD is undefined

Get starred target line by lateral

Get starred target line by lateral UUID. Returns 404 if the lateral has no starred target line

Request

$ curl 'https://solo.cloud/public/api/v1/wells/2b63949f-ead7-4ffa-921e-06d85c2c6512/targetlines/starred' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/2b63949f-ead7-4ffa-921e-06d85c2c6512/targetlines/starred HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: acf6390e3431eec2f792e8777a766eeb
Content-Type: application/json

{
  "name" : "Target Line",
  "uuid" : "ca9c2442-2877-4f5c-bac7-f752299a4ca6"
}

GET /public/api/v1/wells/{uuid}/targetlines/starred

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
uuid String Target line UUID
name String Target line name

Update target line

Update target line name, origin and target points by UUID. All fields are required, all coordinates must be defined. A missing field returns 400, an undefined coordinate 406

For a line with more than two waypoints, the origin and target points are written to its first two waypoints (Origin and WP1 in Get target lines by lateral) and the other waypoints are kept. Use Update target line from waypoints to change any waypoint

Request

$ curl 'https://solo.cloud/public/api/v1/targetlines/65c586a1-3ae7-43b3-904f-66912cd6f31c' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "New target line name",
  "origin_x" : {
    "val" : 1000.5
  },
  "origin_y" : {
    "val" : 2000.5
  },
  "origin_z" : {
    "val" : 3000.5
  },
  "target_x" : {
    "val" : 4000.5
  },
  "target_y" : {
    "val" : 5000.5
  },
  "target_z" : {
    "val" : 6000.5
  }
}'

PATCH /public/api/v1/targetlines/65c586a1-3ae7-43b3-904f-66912cd6f31c HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 283

{
  "name" : "New target line name",
  "origin_x" : {
    "val" : 1000.5
  },
  "origin_y" : {
    "val" : 2000.5
  },
  "origin_z" : {
    "val" : 3000.5
  },
  "target_x" : {
    "val" : 4000.5
  },
  "target_y" : {
    "val" : 5000.5
  },
  "target_z" : {
    "val" : 6000.5
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: c340307d7d0e6efa307dc202220c7b22

PATCH /public/api/v1/targetlines/{uuid}

Path parameter Description
uuid Target line UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Target line name (up to 1000 characters)
origin_x.val Number Origin point X coordinate (project units)
origin_y.val Number Origin point Y coordinate (project units)
origin_z.val Number Origin point Z coordinate (project units)
target_x.val Number Target point X coordinate (project units)
target_y.val Number Target point Y coordinate (project units)
target_z.val Number Target point Z coordinate (project units)

Response body

Empty body

Update target line from waypoints

Replace target line name and waypoints by UUID. At least two waypoints with defined coordinates and unique order values are required. A missing field returns 400, an undefined coordinate 406, fewer than two waypoints or duplicate order values return 400

Request

$ curl 'https://solo.cloud/public/api/v1/targetlines/d0ef5971-d0c8-469f-adea-b5e94cb071e8/fromwaypoints' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Target line updated name",
  "waypoints" : [ {
    "name" : "Waypoint100",
    "break" : false,
    "order" : 2,
    "x" : {
      "val" : 30.0
    },
    "y" : {
      "val" : 10.0
    },
    "z" : {
      "val" : 40.0
    }
  }, {
    "name" : "Waypoint500",
    "break" : false,
    "order" : 3,
    "x" : {
      "val" : 70.0
    },
    "y" : {
      "val" : 80.0
    },
    "z" : {
      "val" : 90.0
    }
  } ]
}'

PATCH /public/api/v1/targetlines/d0ef5971-d0c8-469f-adea-b5e94cb071e8/fromwaypoints HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 433

{
  "name" : "Target line updated name",
  "waypoints" : [ {
    "name" : "Waypoint100",
    "break" : false,
    "order" : 2,
    "x" : {
      "val" : 30.0
    },
    "y" : {
      "val" : 10.0
    },
    "z" : {
      "val" : 40.0
    }
  }, {
    "name" : "Waypoint500",
    "break" : false,
    "order" : 3,
    "x" : {
      "val" : 70.0
    },
    "y" : {
      "val" : 80.0
    },
    "z" : {
      "val" : 90.0
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e7a4547dd5132538aa076955885ca00d

PATCH /public/api/v1/targetlines/{uuid}/fromwaypoints

Path parameter Description
uuid Target line UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Target line name (up to 1000 characters)
waypoints Array Target line waypoints, at least two
waypoints[].name String Waypoint name (up to 200 characters). Get target lines by lateral returns generated names instead
waypoints[].order Number Waypoint order: waypoints are sorted by it, values must be unique
waypoints[].x.val Number Waypoint X coordinate (project units)
waypoints[].y.val Number Waypoint Y coordinate (project units)
waypoints[].z.val Number Waypoint Z coordinate (project units)
waypoints[].break Boolean Is the waypoint break point or not

Response body

Empty body

Delete target line

Delete target line by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/targetlines/598a91c1-e891-4a2a-b911-4e6803f8c0ec' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/targetlines/598a91c1-e891-4a2a-b911-4e6803f8c0ec HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 54e1d2a09de18208e26d975f9cff725d

DELETE /public/api/v1/targetlines/{uuid}

Path parameter Description
uuid Target line UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

10. Logs

Create lateral log

Create log by lateral UUID. The log is created without data and is not listed by Get logs by lateral until data is uploaded with Extend log data or Replace log data

Request

$ curl 'https://solo.cloud/public/api/v1/wells/5326696d-0c4d-4ee2-aa58-1a0134e44f3b/logs' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Log name"
}'

POST /public/api/v1/wells/5326696d-0c4d-4ee2-aa58-1a0134e44f3b/logs HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 25

{
  "name" : "Log name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 18f6f36c4b0f1fafb2518f2f93d8a647
Content-Type: application/json

{
  "uuid" : "273b5d8e-176c-4402-b5f0-dba4747171b3"
}

POST /public/api/v1/wells/{uuid}/logs

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Log name, up to 200 characters
unit String Measure unit of the log data values, up to 100 characters

Response body

Path Type Description
uuid String Created log UUID

Create typewell log

Create log by typewell UUID. The log is created without data and is not listed by Get logs by typewell until data is uploaded with Extend log data or Replace log data

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/730b7128-8fae-414f-92ec-494ccde50e19/logs' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Log name"
}'

POST /public/api/v1/typewells/730b7128-8fae-414f-92ec-494ccde50e19/logs HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 25

{
  "name" : "Log name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: dbfee4732668fd2688fd9ddc77653775
Content-Type: application/json

{
  "uuid" : "2a96b67c-e613-4336-8ff2-67c336d33ace"
}

POST /public/api/v1/typewells/{uuid}/logs

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Log name, up to 200 characters
unit String Measure unit of the log data values, up to 100 characters

Response body

Path Type Description
uuid String Created log UUID

Get logs by lateral

Get a list of logs by lateral UUID with pagination, in creation order. Logs that do not contain data will not be included in the response. After creating the log, you need to fill it with data using the commands Extend log data or Replace log data

Request

$ curl 'https://solo.cloud/public/api/v1/wells/30f04b24-cb75-4d8d-96ff-c839cd9c58ae/logs?offset=0&limit=10&filter=mMa' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/30f04b24-cb75-4d8d-96ff-c839cd9c58ae/logs?offset=0&limit=10&filter=mMa HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 2cbe52d1abfdf9e4726581c56295daaa
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "91fc065c-d3c5-478b-b793-92f8254dc213",
    "name" : "Gamma Ray",
    "is_discrete" : false
  }, {
    "uuid" : "5c238e58-49f8-4d9d-965d-87c8a69cbce9",
    "name" : "Gamma Discrete",
    "is_discrete" : true,
    "discrete_log_palette" : {
      "palette_pairs" : [ {
        "palette" : {
          "name" : "Name 1",
          "color" : "#ffffff00"
        },
        "discrete_value" : 1
      }, {
        "palette" : {
          "name" : "Name 2",
          "color" : "#ff008000"
        },
        "discrete_value" : 2
      }, {
        "palette" : {
          "name" : "Name 3",
          "color" : "#ff000000"
        },
        "discrete_value" : 3
      }, {
        "palette" : {
          "name" : "Name 4",
          "color" : "#ff00bfff"
        },
        "discrete_value" : 4
      } ],
      "out_of_range_color" : "#ff8f9ac1"
    }
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/logs

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the logs whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Log name
content[].unit String Measure unit of the log data values. Absent when not set
content[].is_discrete Boolean true for discrete logs, otherwise false
content[].discrete_log_palette Object Discrete log palette settings. Present only for discrete logs
content[].discrete_log_palette.palette_pairs Array Palette mappings for discrete values
content[].discrete_log_palette.palette_pairs[].palette Object Palette item for the discrete value
content[].discrete_log_palette.palette_pairs[].palette.name String Palette item name
content[].discrete_log_palette.palette_pairs[].palette.color String Palette item color: # followed by 8 hex digits, e.g. #ff00bfff
content[].discrete_log_palette.palette_pairs[].discrete_value Number Discrete value mapped to the palette item
content[].discrete_log_palette.out_of_range_color String Out-of-range color for discrete log palette
content[].uuid String Log UUID

Get logs by typewell

Get a list of logs by typewell UUID with pagination, in creation order. Logs that do not contain data will not be included in the response. After creating the log, you need to fill it with data using the commands Extend log data or Replace log data

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/e5ec93f8-b90e-484b-ab3a-3d6d2b16e2f7/logs?offset=0&limit=10&filter=mMa' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/e5ec93f8-b90e-484b-ab3a-3d6d2b16e2f7/logs?offset=0&limit=10&filter=mMa HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ea3735610faaa766b1ad0ed89ab0bdb2
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "0131c899-54ff-421f-8714-992ca6f7898f",
    "name" : "Gamma Ray",
    "is_discrete" : false
  }, {
    "uuid" : "a6971baa-3510-4d4a-8df2-e054bbccc306",
    "name" : "Gamma Discrete",
    "is_discrete" : true,
    "discrete_log_palette" : {
      "palette_pairs" : [ {
        "palette" : {
          "name" : "Name 1",
          "color" : "#ffffff00"
        },
        "discrete_value" : 1
      }, {
        "palette" : {
          "name" : "Name 2",
          "color" : "#ff008000"
        },
        "discrete_value" : 2
      }, {
        "palette" : {
          "name" : "Name 3",
          "color" : "#ff000000"
        },
        "discrete_value" : 3
      }, {
        "palette" : {
          "name" : "Name 4",
          "color" : "#ff00bfff"
        },
        "discrete_value" : 4
      } ],
      "out_of_range_color" : "#ff8f9ac1"
    }
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/typewells/{uuid}/logs

Path parameter Description
uuid Typewell UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the logs whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Log name
content[].unit String Measure unit of the log data values. Absent when not set
content[].is_discrete Boolean true for discrete logs, otherwise false
content[].discrete_log_palette Object Discrete log palette settings. Present only for discrete logs
content[].discrete_log_palette.palette_pairs Array Palette mappings for discrete values
content[].discrete_log_palette.palette_pairs[].palette Object Palette item for the discrete value
content[].discrete_log_palette.palette_pairs[].palette.name String Palette item name
content[].discrete_log_palette.palette_pairs[].palette.color String Palette item color: # followed by 8 hex digits, e.g. #ff00bfff
content[].discrete_log_palette.palette_pairs[].discrete_value Number Discrete value mapped to the palette item
content[].discrete_log_palette.out_of_range_color String Out-of-range color for discrete log palette
content[].uuid String Log UUID

Get log data

Get log data by UUID. MD values are returned in the project depth unit, data values as stored. An undefined value is returned as {"undefined": true} instead of {"val": ...}. Returns 404 if the log has no data yet

Request

$ curl 'https://solo.cloud/public/api/v1/logs/500f318b-ac7d-40ca-8729-60c34cd27f92/data' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/logs/500f318b-ac7d-40ca-8729-60c34cd27f92/data HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 868e5acf27d6ba5bb13520cbfe10175a
Content-Type: application/json

{
  "log_points" : [ {
    "data" : {
      "val" : -3688.6927
    },
    "md" : {
      "val" : 744.6263999999999
    }
  }, {
    "data" : {
      "val" : 16.581
    },
    "md" : {
      "val" : 744.7787999999999
    }
  }, {
    "data" : {
      "val" : -11.85
    },
    "md" : {
      "val" : 744.9311999999999
    }
  }, {
    "data" : {
      "val" : 15.187
    },
    "md" : {
      "val" : 745.0835999999999
    }
  }, {
    "data" : {
      "val" : -4.363
    },
    "md" : {
      "val" : 745.2359999999999
    }
  }, {
    "data" : {
      "val" : -40.475
    },
    "md" : {
      "val" : 745.3883999999999
    }
  }, {
    "data" : {
      "val" : 61.463
    },
    "md" : {
      "val" : 745.5407999999999
    }
  }, {
    "data" : {
      "val" : 82.305
    },
    "md" : {
      "val" : 745.6931999999999
    }
  }, {
    "data" : {
      "val" : 114.139
    },
    "md" : {
      "val" : 745.8455999999999
    }
  }, {
    "data" : {
      "val" : 144.503
    },
    "md" : {
      "val" : 745.9979999999999
    }
  } ]
}

GET /public/api/v1/logs/{uuid}/data

Path parameter Description
uuid Log UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
log_points Array Points array
log_points[].data Object Point data. For an undefined (null) value it is {"undefined": true} without val
log_points[].data.val Number Point data value in the log unit, as stored
log_points[].md Object Point MD
log_points[].md.val Number Point MD value in the project depth unit (m or ft)

Update log metadata

Update log metadata by UUID. Only the fields present in the request are changed. To make a log discrete, pass is_discrete = true together with discrete_log_palette: the log data must hold integer values only, and the set of palette discrete_value values must be equal to the set of defined log data values. Making a log discrete also sets its display range to the minimum and maximum palette discrete_value

Request

$ curl 'https://solo.cloud/public/api/v1/logs/8a3cee5d-5cd9-4cf2-9c09-a8a081777d58' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "New log name",
  "is_discrete" : true,
  "discrete_log_palette" : {
    "palette_pairs" : [ {
      "palette" : {
        "name" : "Name 1",
        "color" : "#ffffff00"
      },
      "discrete_value" : 1
    }, {
      "palette" : {
        "name" : "Name 2",
        "color" : "#ff008000"
      },
      "discrete_value" : 2
    }, {
      "palette" : {
        "name" : "Name 3",
        "color" : "#ff000000"
      },
      "discrete_value" : 3
    }, {
      "palette" : {
        "name" : "Name 4",
        "color" : "#ff00bfff"
      },
      "discrete_value" : 4
    } ],
    "out_of_range_color" : "#ff8f9ac1"
  }
}'

PATCH /public/api/v1/logs/8a3cee5d-5cd9-4cf2-9c09-a8a081777d58 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 640

{
  "name" : "New log name",
  "is_discrete" : true,
  "discrete_log_palette" : {
    "palette_pairs" : [ {
      "palette" : {
        "name" : "Name 1",
        "color" : "#ffffff00"
      },
      "discrete_value" : 1
    }, {
      "palette" : {
        "name" : "Name 2",
        "color" : "#ff008000"
      },
      "discrete_value" : 2
    }, {
      "palette" : {
        "name" : "Name 3",
        "color" : "#ff000000"
      },
      "discrete_value" : 3
    }, {
      "palette" : {
        "name" : "Name 4",
        "color" : "#ff00bfff"
      },
      "discrete_value" : 4
    } ],
    "out_of_range_color" : "#ff8f9ac1"
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 2b5e0f7acabddb1cf31b2b61b0a4752e

PATCH /public/api/v1/logs/{uuid}

Path parameter Description
uuid Log UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String New log name, up to 200 characters. Omit it to keep the current name
unit String Measure unit of the log data values, up to 100 characters. The values themselves are not converted
is_discrete Boolean true to make the log discrete (requires discrete_log_palette and log data), false to make it non-discrete. Omit it to keep the current setting
discrete_log_palette Object Discrete log palette settings. Required when is_discrete is true, ignored otherwise
discrete_log_palette.palette_pairs Array Palette mappings for discrete values, 1 to 50 items. The set of discrete_value values must be equal to the set of defined log data values, which must all be integers
discrete_log_palette.palette_pairs[].palette Object Palette item for the discrete value
discrete_log_palette.palette_pairs[].palette.name String Palette item name
discrete_log_palette.palette_pairs[].palette.color String Palette item color: # followed by 8 hex digits, e.g. #ff00bfff
discrete_log_palette.palette_pairs[].discrete_value Number Discrete value mapped to the palette item: an integer, unique within the palette
discrete_log_palette.out_of_range_color String Out-of-range color for discrete log palette: # followed by 8 hex digits

Response body

Empty body

Extend log data

Append points to the log data. Only the request points with MD greater than the last MD of the existing data are added, the other request points are ignored. If the log has no data yet, all points are stored. The new data can become visible in Get log data with a short delay after a successful response

Request

$ curl 'https://solo.cloud/public/api/v1/logs/72f74b87-1caa-41c9-a721-3633f8b1da80/data' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "log_points" : [ {
    "value" : {
      "val" : 96.36
    },
    "index" : {
      "val" : 6494.5
    }
  }, {
    "value" : {
      "val" : 16.36
    },
    "index" : {
      "val" : -999.25
    }
  } ],
  "value_unit" : "ft",
  "index_unit" : "ft"
}'

PATCH /public/api/v1/logs/72f74b87-1caa-41c9-a721-3633f8b1da80/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 256

{
  "log_points" : [ {
    "value" : {
      "val" : 96.36
    },
    "index" : {
      "val" : 6494.5
    }
  }, {
    "value" : {
      "val" : 16.36
    },
    "index" : {
      "val" : -999.25
    }
  } ],
  "value_unit" : "ft",
  "index_unit" : "ft"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e665882dcc127f79a10f6ed154969c8c

PATCH /public/api/v1/logs/{uuid}/data

Path parameter Description
uuid Log UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
index_unit String Measure unit of the point MD (index) values: m, ft or ftUS (case-sensitive). Defaults to the project depth unit
value_unit String Measure unit of the point data values, up to 100 characters. The values are not converted to another unit. When it differs from the current log unit, the log unit is updated. Omit it to keep the current log unit
log_points Array Log points array, at least one point with a defined index, otherwise 400 is returned. Each point must contain both index and value
log_points[].value.val Number Point data value. For an undefined (null) value pass {"undefined": true} as value. Null-value markers such as -999.25, -999, -9999, -32767 and -99999 are stored as undefined values
log_points[].index.val Number Point MD value in index_unit

Response body

Empty body

Replace log data

Replace all points of the log data with the points of the request. The new data can become visible in Get log data with a short delay after a successful response

Request

$ curl 'https://solo.cloud/public/api/v1/logs/500f318b-ac7d-40ca-8729-60c34cd27f92/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "log_points" : [ {
    "value" : {
      "val" : 96.36
    },
    "index" : {
      "val" : 6494.5
    }
  }, {
    "value" : {
      "val" : 16.36
    },
    "index" : {
      "val" : -999.25
    }
  } ],
  "value_unit" : "ft",
  "index_unit" : "ft"
}'

PUT /public/api/v1/logs/500f318b-ac7d-40ca-8729-60c34cd27f92/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 256

{
  "log_points" : [ {
    "value" : {
      "val" : 96.36
    },
    "index" : {
      "val" : 6494.5
    }
  }, {
    "value" : {
      "val" : 16.36
    },
    "index" : {
      "val" : -999.25
    }
  } ],
  "value_unit" : "ft",
  "index_unit" : "ft"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 9e1104b73f4ea59d775f312f6a22a412

PUT /public/api/v1/logs/{uuid}/data

Path parameter Description
uuid Log UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
index_unit String Measure unit of the point MD (index) values: m, ft or ftUS (case-sensitive). Defaults to the project depth unit
value_unit String Measure unit of the point data values, up to 100 characters. The values are not converted to another unit. When it differs from the current log unit, the log unit is updated. Omit it to keep the current log unit
log_points Array Log points array, at least one point with a defined index, otherwise 400 is returned. Each point must contain both index and value
log_points[].value.val Number Point data value. For an undefined (null) value pass {"undefined": true} as value. Null-value markers such as -999.25, -999, -9999, -32767 and -99999 are stored as undefined values
log_points[].index.val Number Point MD value in index_unit

Response body

Empty body

Move log to well folder

Move log into a folder (at any nesting level) of the lateral or typewell it belongs to, or to the well root when folder is null or omitted. A folder that is not found or belongs to another well returns 400

Request

$ curl 'https://solo.cloud/public/api/v1/logs/4363976f-c2d9-4664-98e7-299a483f17e7/folder' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "folder" : "63ea50bf-b9f6-4bb6-9fd5-8eb5f0fbe1a0"
}'

PUT /public/api/v1/logs/4363976f-c2d9-4664-98e7-299a483f17e7/folder HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 55

{
  "folder" : "63ea50bf-b9f6-4bb6-9fd5-8eb5f0fbe1a0"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f480f3c587dc8eecb7c2e5438240ca4a

PUT /public/api/v1/logs/{uuid}/folder

Path parameter Description
uuid Log UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
folder String UUID of a folder of the lateral or typewell the log belongs to. Pass null or omit it to move the log to the well root

Response body

Empty body

Delete log

Delete log by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/logs/4363976f-c2d9-4664-98e7-299a483f17e7' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/logs/4363976f-c2d9-4664-98e7-299a483f17e7 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 6b2419ab2cc6d730f800924380ac2f4d

DELETE /public/api/v1/logs/{uuid}

Path parameter Description
uuid Log UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

11. Images

Create image

Create image by lateral UUID. The image is placed on the lateral vertical section by its bottom_left and top_right corners (VS in the project horizontal unit, TVDSS in the project depth unit, for METER_FOOT VS is in meters and TVDSS in feet), bottom_left values must be less than the top_right ones. The image is created without content, upload it with Upload image

Request

$ curl 'https://solo.cloud/public/api/v1/wells/12a28203-7dfc-4b7e-9e15-08df6db4d262/images' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "image name",
  "azimuth" : {
    "val" : 0.0
  },
  "bottom_left" : {
    "vs" : {
      "val" : -30.0
    },
    "tvdss" : {
      "val" : -67.0
    }
  },
  "top_right" : {
    "vs" : {
      "val" : 50.0
    },
    "tvdss" : {
      "val" : -50.0
    }
  }
}'

POST /public/api/v1/wells/12a28203-7dfc-4b7e-9e15-08df6db4d262/images HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 275

{
  "name" : "image name",
  "azimuth" : {
    "val" : 0.0
  },
  "bottom_left" : {
    "vs" : {
      "val" : -30.0
    },
    "tvdss" : {
      "val" : -67.0
    }
  },
  "top_right" : {
    "vs" : {
      "val" : 50.0
    },
    "tvdss" : {
      "val" : -50.0
    }
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: b2210b16416a3d92a14d38b18677c286
Content-Type: application/json

{
  "uuid" : "dc1fb9a6-e4bf-4c98-9c77-d23caae7660c"
}

POST /public/api/v1/wells/{uuid}/images

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Image name, 2 to 200 characters, must not start or end with a whitespace character
azimuth.val Number Azimuth (degrees) the image applies to. If omitted, the lateral azimuth (0 if the lateral has none) is applied (on update the current image azimuth is not kept)
bottom_left Object Bottom left corner of the image. Its vs and tvdss must be less than those of top_right
top_right Object Top right corner of the image
bottom_left.vs.val Number VS point coordinate value in the project horizontal unit (meters for METER_FOOT)
bottom_left.tvdss.val Number TVDSS point coordinate value in the project depth unit (feet for METER_FOOT)
top_right.vs.val Number VS point coordinate value in the project horizontal unit (meters for METER_FOOT)
top_right.tvdss.val Number TVDSS point coordinate value in the project depth unit (feet for METER_FOOT)

Response body

Path Type Description
uuid String Created image UUID

Update image

Update image name, azimuth and corners by UUID. The image content is not changed. If azimuth is omitted, the lateral azimuth is applied. name, bottom_left and top_right with defined vs and tvdss are required, otherwise 400 is returned

Request

$ curl 'https://solo.cloud/public/api/v1/images/49620a1a-d4da-48d7-b6aa-360f746fba2b' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "new image name",
  "azimuth" : {
    "val" : 0.0
  },
  "bottom_left" : {
    "vs" : {
      "val" : -100.0
    },
    "tvdss" : {
      "val" : -50.0
    }
  },
  "top_right" : {
    "vs" : {
      "val" : -50.0
    },
    "tvdss" : {
      "val" : -40.0
    }
  }
}'

PUT /public/api/v1/images/49620a1a-d4da-48d7-b6aa-360f746fba2b HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 281

{
  "name" : "new image name",
  "azimuth" : {
    "val" : 0.0
  },
  "bottom_left" : {
    "vs" : {
      "val" : -100.0
    },
    "tvdss" : {
      "val" : -50.0
    }
  },
  "top_right" : {
    "vs" : {
      "val" : -50.0
    },
    "tvdss" : {
      "val" : -40.0
    }
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: d63ff3d19db6d1234c9ac34867b2e380

PUT /public/api/v1/images/{uuid}

Path parameter Description
uuid Image UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Image name, 2 to 200 characters, must not start or end with a whitespace character
azimuth.val Number Azimuth (degrees) the image applies to. If omitted, the lateral azimuth (0 if the lateral has none) is applied (on update the current image azimuth is not kept)
bottom_left Object Bottom left corner of the image. Its vs and tvdss must be less than those of top_right
top_right Object Top right corner of the image
bottom_left.vs.val Number VS point coordinate value in the project horizontal unit (meters for METER_FOOT)
bottom_left.tvdss.val Number TVDSS point coordinate value in the project depth unit (feet for METER_FOOT)
top_right.vs.val Number VS point coordinate value in the project horizontal unit (meters for METER_FOOT)
top_right.tvdss.val Number TVDSS point coordinate value in the project depth unit (feet for METER_FOOT)

Response body

Empty body

Upload image

Upload image content by UUID, replacing the previous content. The request body is the image file. Only PNG images are accepted (the format is detected from the content), width and height must not exceed 10000 pixels by default, otherwise 400 is returned. Send the file as raw bytes, e.g. curl --data-binary @image.png -H 'Content-Type: image/png' ...

Request

$ curl 'https://solo.cloud/public/api/v1/images/ee3b7583-ac7b-418a-9d80-d6fef77209e9/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: image/png; charset=ISO-8859-1' \
    -d '<binary image data>'

PUT /public/api/v1/images/ee3b7583-ac7b-418a-9d80-d6fef77209e9/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: image/png; charset=ISO-8859-1
Host: solo.cloud
Content-Length: 19

<binary image data>

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 1abf6c1fe2d7a59f86514cd39f6a0eb9

PUT /public/api/v1/images/{uuid}/data

Path parameter Description
uuid Image UUID
Header Description
Authorization OAuth2 authorization header
Content-Type Must be image/png, the request body is the PNG file

Response body

Empty body

Upload image (multipart)

Same as Upload image, but the file is sent in the image part of a multipart/form-data request

Request

$ curl 'https://solo.cloud/public/api/v1/images/218427a1-e078-4710-89ba-bc11abe7763a/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: multipart/form-data' \
    -F 'image=<binary image data>;type=image/png'

PUT /public/api/v1/images/218427a1-e078-4710-89ba-bc11abe7763a/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Host: solo.cloud

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=image
Content-Type: image/png

<binary image data>
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 742a1c6238e9919dbe05546019a042fa

PUT /public/api/v1/images/{uuid}/data

Path parameter Description
uuid Image UUID
Part Description
image Request part containing PNG image
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

12. Mudlogs

Create lateral mudlog

Create an empty mudlog by lateral UUID. Mudlog names do not have to be unique. The mudlog is not listed by Get mudlogs by lateral until its data is uploaded

Request

$ curl 'https://solo.cloud/public/api/v1/wells/0e396d02-5ff3-4b71-bac9-68f02da5a230/mudlogs' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Mudlog name"
}'

POST /public/api/v1/wells/0e396d02-5ff3-4b71-bac9-68f02da5a230/mudlogs HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 28

{
  "name" : "Mudlog name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 8920a6bf8a716903b84c818382ec59d1
Content-Type: application/json

{
  "uuid" : "243c2f5a-9f10-4757-a7e1-24067d001f48"
}

POST /public/api/v1/wells/{uuid}/mudlogs

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Mudlog name, up to 200 characters

Response body

Path Type Description
uuid String Created mudlog UUID

Create typewell mudlog

Create an empty mudlog by typewell UUID. Mudlog names do not have to be unique. The mudlog is not listed by Get mudlogs by typewell until its data is uploaded

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/bb55e771-c3d9-4e86-878b-895f6e8ceaef/mudlogs' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Mudlog name"
}'

POST /public/api/v1/typewells/bb55e771-c3d9-4e86-878b-895f6e8ceaef/mudlogs HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 28

{
  "name" : "Mudlog name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 61af8c1700f8c7387fce9b49eda6399f
Content-Type: application/json

{
  "uuid" : "dc9cfd7b-cb03-467b-aad4-b8bc55e0c103"
}

POST /public/api/v1/typewells/{uuid}/mudlogs

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Mudlog name, up to 200 characters

Response body

Path Type Description
uuid String Created mudlog UUID

Get mudlogs by lateral

Get a list of mudlogs by lateral UUID with pagination, in creation order. Mudlogs that do not contain data will not be included in the response

Request

$ curl 'https://solo.cloud/public/api/v1/wells/0e396d02-5ff3-4b71-bac9-68f02da5a230/mudlogs?offset=0&limit=10&filter=mMa' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/0e396d02-5ff3-4b71-bac9-68f02da5a230/mudlogs?offset=0&limit=10&filter=mMa HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: aa84fbaf5670611e56dce5e70669bd08
Content-Type: application/json

{
  "content" : [ {
    "name" : "Gamma Ray",
    "uuid" : "014dd4a2-bc64-4976-bc22-3780774ed572"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/mudlogs

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the mudlogs whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Mudlog name
content[].uuid String Mudlog UUID

Get mudlogs by typewell

Get a list of mudlogs by typewell UUID with pagination, in creation order. Mudlogs that do not contain data will not be included in the response

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/bb55e771-c3d9-4e86-878b-895f6e8ceaef/mudlogs?offset=0&limit=10&filter=mMa' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/bb55e771-c3d9-4e86-878b-895f6e8ceaef/mudlogs?offset=0&limit=10&filter=mMa HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: b328f73dfc1d391591fa4b5d51590d6d
Content-Type: application/json

{
  "content" : [ {
    "name" : "Gamma Ray",
    "uuid" : "365505e1-f5be-464c-81c0-095b11a25e0e"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/typewells/{uuid}/mudlogs

Path parameter Description
uuid Typewell UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the mudlogs whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].name String Mudlog name
content[].uuid String Mudlog UUID

Get mudlog data

Get mudlog data by UUID. MD values are returned in project depth units. Channel display settings (lithology_type, solid_color, pattern_color) are not returned. Returns 400 if the mudlog has no data

Request

$ curl 'https://solo.cloud/public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b/data' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b/data HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: b09e130cfce1c5814f6f27e605bead71
Content-Type: application/json

{
  "logs" : [ {
    "uuid" : "f35eddbd-418c-43ac-86d8-7bb6cfac278f",
    "name" : "Mudlog channel1",
    "unit" : "Mudlog channel1 unit",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "undefined" : true
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "val" : 2.0
      }
    } ]
  }, {
    "uuid" : "fba9bb23-b49a-43d7-8aa4-0a2741982501",
    "name" : "Mudlog channel2",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "val" : 178.0
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "undefined" : true
      }
    } ]
  }, {
    "uuid" : "63ba0fb0-8aaa-4f9e-b685-0dce99fa0eb8",
    "name" : "Mudlog channel1",
    "unit" : "Mudlog channel1 unit",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "undefined" : true
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "val" : 2.0
      }
    } ]
  }, {
    "uuid" : "1dbc1d59-1730-49c6-950a-e10756f7d577",
    "name" : "Mudlog channel2",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "val" : 178.0
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "undefined" : true
      }
    } ]
  } ]
}

GET /public/api/v1/mudlogs/{uuid}/data

Path parameter Description
uuid Mudlog UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
logs[].uuid String Channel UUID, generated by the server for data uploaded through the public upload and append endpoints
logs[].name String Channel name
logs[].unit String Channel unit
logs[].log_points Array Channel points
logs[].log_points[].md.val Number Point MD value (project depth units)
logs[].log_points[].data.val Number Point data value
logs[].log_points[].data.undefined Boolean true if point data value is undefined

Update mudlog metadata

Rename mudlog by UUID. Only name can be changed, the mudlog data is not changed

Request

$ curl 'https://solo.cloud/public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Updated mudlog name"
}'

PATCH /public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 36

{
  "name" : "Updated mudlog name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 5d68984a0b731c3a39e0d3e7812a5030

PATCH /public/api/v1/mudlogs/{uuid}

Path parameter Description
uuid Mudlog UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String New mudlog name, up to 200 characters

Response body

Empty body

Upload\replace mudlog data

Upload mudlog data by UUID, replacing all existing channels. MD values are in project depth units, all channels of the request must have the same set of MD values, points are stored sorted by MD. Channel UUIDs are assigned by the server, the mudlog display settings are rebuilt from defaults with the channel lithology_type, solid_color and pattern_color of the request and visual_bound_max applied

Request

$ curl 'https://solo.cloud/public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b/data?visual_bound_max=100.5' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "logs" : [ {
    "name" : "Mudlog channel1",
    "unit" : "Mudlog channel1 unit",
    "lithology_type" : "HALITE",
    "solid_color" : "BLUE",
    "pattern_color" : "GREEN",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "undefined" : true
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "val" : 2.0
      }
    } ]
  }, {
    "name" : "Mudlog channel2",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "val" : 178.0
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "undefined" : true
      }
    } ]
  } ]
}'

PUT /public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b/data?visual_bound_max=100.5 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 684

{
  "logs" : [ {
    "name" : "Mudlog channel1",
    "unit" : "Mudlog channel1 unit",
    "lithology_type" : "HALITE",
    "solid_color" : "BLUE",
    "pattern_color" : "GREEN",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "undefined" : true
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "val" : 2.0
      }
    } ]
  }, {
    "name" : "Mudlog channel2",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "val" : 178.0
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "undefined" : true
      }
    } ]
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 025b3ec2135498ef4005912a87c375a4

PUT /public/api/v1/mudlogs/{uuid}/data

Path parameter Description
uuid Mudlog UUID
Parameter Description
visual_bound_max Optional. Upper bound of the mudlog display scale, applied only if greater than 0. If not set, it is calculated from the uploaded data
Header Description
Authorization OAuth2 authorization header
Body field Type Description
logs Array Mudlog channels that replace all existing channels of the mudlog. All channels must have the same set of MD values
logs[].name String Channel name, up to 200 characters
logs[].unit String Optional. Channel unit, up to 100 characters
logs[].lithology_type String Optional. Channel lithology, sets the fill pattern of the channel. Allowed values are 'EMPTY', 'CLAY_SHALE', 'SAND_SANDSTONE', 'ARGILLACEOUS_OR_SHALY_SAND', 'LIMESTONE', 'SANDY_LIMESTONE', 'DOLOMITE', 'GYPSUM', 'SALT', 'CHALK', 'HALITE', 'BRECCIA', 'OPEN_UPWARD_TRIANGLES', 'SANDY_OR_SILTY_SHALE', 'SILTY_LIMESTONE', 'ARGILLACEOUS_SHALY_LIMESTONE', 'DOLOMITIC_LIMESTONE_LIMY_DOLOMITE', 'SANDY_DOLOMITE', 'SILTY_DOLOMITE', 'ARGILLACEOUS_SHALY_DOLOMITE', 'SILT_SILTSTONE', 'DOLOMITIC_SILTSTONE', 'ANHYDRITE', 'IGNEOUS', 'METAMORPHIC', 'CALCARENITE', 'CALCARENITE_DOLOMITE', 'CALCARENITIC_LIMESTONE', 'MARL', 'COARSE_CLASTIC_CARBONATE', 'DOLOMITIC_SAND', 'SILTSTONE', 'INGE', 'HAL', 'TILL', 'CEMENT', 'MARLSTONE', 'CLAY', 'SHALE', 'SCHOL', 'SHGY', 'IGNVOLC', 'CHERT', 'CONGLOMERATE', 'CGL', 'META', 'BENT', 'ANHY', 'GYP', 'SANDSTONE', 'CONGLOMERATIC_SANDSTONE', 'BENTONITE', 'BRECCIAS', 'MARLS', 'PACKSTONE', 'WACKESTONE'
logs[].solid_color String Optional. Channel fill color. Allowed values are 'CYAN_BLUE', 'BLUE', 'INDIGO', 'GREEN', 'TEAL_GREEN', 'TEAL', 'OLIVE_YELLOW', 'GOLD', 'ORANGE', 'RED_ORANGE', 'RED', 'PINK', 'MAGENTA', 'DARK_BLUE_GRAY', 'GRAY'
logs[].pattern_color String Optional. Color of the channel fill pattern. Allowed values are 'CYAN_BLUE', 'BLUE', 'INDIGO', 'GREEN', 'TEAL_GREEN', 'TEAL', 'OLIVE_YELLOW', 'GOLD', 'ORANGE', 'RED_ORANGE', 'RED', 'PINK', 'MAGENTA', 'DARK_BLUE_GRAY', 'GRAY'
logs[].log_points Array Channel points, each point must have md and data
logs[].log_points[].md.val Number Point MD value (project depth units). Must be defined, non-negative and unique within the channel
logs[].log_points[].data.val Number Point data value
logs[].log_points[].data.undefined Boolean true if point data value is undefined

Response body

Empty body

Append mudlog data

Append the channels of the request to the mudlog with the given UUID, the existing channels are kept unchanged. A channel is not merged into an existing channel with the same name, it is added as another channel. The request format is the same as in Upload\replace mudlog data. For a mudlog without data it works as upload

Request

$ curl 'https://solo.cloud/public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b/data?visual_bound_max=100.5' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "logs" : [ {
    "name" : "Mudlog channel1",
    "unit" : "Mudlog channel1 unit",
    "lithology_type" : "HALITE",
    "solid_color" : "BLUE",
    "pattern_color" : "GREEN",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "undefined" : true
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "val" : 2.0
      }
    } ]
  }, {
    "name" : "Mudlog channel2",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "val" : 178.0
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "undefined" : true
      }
    } ]
  } ]
}'

PATCH /public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b/data?visual_bound_max=100.5 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 684

{
  "logs" : [ {
    "name" : "Mudlog channel1",
    "unit" : "Mudlog channel1 unit",
    "lithology_type" : "HALITE",
    "solid_color" : "BLUE",
    "pattern_color" : "GREEN",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "undefined" : true
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "val" : 2.0
      }
    } ]
  }, {
    "name" : "Mudlog channel2",
    "log_points" : [ {
      "md" : {
        "val" : 100.0
      },
      "data" : {
        "val" : 178.0
      }
    }, {
      "md" : {
        "val" : 200.0
      },
      "data" : {
        "undefined" : true
      }
    } ]
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 9bea59a878b6615cabc4e9a3780681ea

PATCH /public/api/v1/mudlogs/{uuid}/data

Path parameter Description
uuid Mudlog UUID
Parameter Description
visual_bound_max Optional. Upper bound of the mudlog display scale, applied only if greater than 0. If not set, the current value is kept, or it is calculated from the uploaded data if the mudlog has no data yet
Header Description
Authorization OAuth2 authorization header
Body field Type Description
logs Array Mudlog channels to add to the existing channels of the mudlog. All channels in the request must have the same set of MD values
logs[].name String Channel name, up to 200 characters
logs[].unit String Optional. Channel unit, up to 100 characters
logs[].lithology_type String Optional. Channel lithology, sets the fill pattern of the channel. Allowed values are 'EMPTY', 'CLAY_SHALE', 'SAND_SANDSTONE', 'ARGILLACEOUS_OR_SHALY_SAND', 'LIMESTONE', 'SANDY_LIMESTONE', 'DOLOMITE', 'GYPSUM', 'SALT', 'CHALK', 'HALITE', 'BRECCIA', 'OPEN_UPWARD_TRIANGLES', 'SANDY_OR_SILTY_SHALE', 'SILTY_LIMESTONE', 'ARGILLACEOUS_SHALY_LIMESTONE', 'DOLOMITIC_LIMESTONE_LIMY_DOLOMITE', 'SANDY_DOLOMITE', 'SILTY_DOLOMITE', 'ARGILLACEOUS_SHALY_DOLOMITE', 'SILT_SILTSTONE', 'DOLOMITIC_SILTSTONE', 'ANHYDRITE', 'IGNEOUS', 'METAMORPHIC', 'CALCARENITE', 'CALCARENITE_DOLOMITE', 'CALCARENITIC_LIMESTONE', 'MARL', 'COARSE_CLASTIC_CARBONATE', 'DOLOMITIC_SAND', 'SILTSTONE', 'INGE', 'HAL', 'TILL', 'CEMENT', 'MARLSTONE', 'CLAY', 'SHALE', 'SCHOL', 'SHGY', 'IGNVOLC', 'CHERT', 'CONGLOMERATE', 'CGL', 'META', 'BENT', 'ANHY', 'GYP', 'SANDSTONE', 'CONGLOMERATIC_SANDSTONE', 'BENTONITE', 'BRECCIAS', 'MARLS', 'PACKSTONE', 'WACKESTONE'
logs[].solid_color String Optional. Channel fill color. Allowed values are 'CYAN_BLUE', 'BLUE', 'INDIGO', 'GREEN', 'TEAL_GREEN', 'TEAL', 'OLIVE_YELLOW', 'GOLD', 'ORANGE', 'RED_ORANGE', 'RED', 'PINK', 'MAGENTA', 'DARK_BLUE_GRAY', 'GRAY'
logs[].pattern_color String Optional. Color of the channel fill pattern. Allowed values are 'CYAN_BLUE', 'BLUE', 'INDIGO', 'GREEN', 'TEAL_GREEN', 'TEAL', 'OLIVE_YELLOW', 'GOLD', 'ORANGE', 'RED_ORANGE', 'RED', 'PINK', 'MAGENTA', 'DARK_BLUE_GRAY', 'GRAY'
logs[].log_points Array Channel points, each point must have md and data
logs[].log_points[].md.val Number Point MD value (project depth units). Must be defined, non-negative and unique within the channel
logs[].log_points[].data.val Number Point data value
logs[].log_points[].data.undefined Boolean true if point data value is undefined

Response body

Empty body

Delete mudlog

Delete mudlog by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/mudlogs/f2cec40c-b934-40bf-9d33-6504c687c89b HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 6adc53d19cf750ab07b33c73b892311c

DELETE /public/api/v1/mudlogs/{uuid}

Path parameter Description
uuid Mudlog UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

13. Drilling traces

Get traces collection

Get the list of traces available to the user's company: system traces, including robot-calculated ones (Rig Activity, KPIs, Slide Sheet), and custom traces of the company

Request

$ curl 'https://solo.cloud/public/api/v1/traces' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/traces HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ac79d347891f6691b86825d28525340e
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "f18afa65-7b06-4f6a-9494-746b3f10272f",
    "name" : "Axial Shock"
  }, {
    "uuid" : "97e29152-c59d-4055-b7e3-7d823e3eb122",
    "name" : "Axial Vibration"
  }, {
    "uuid" : "a415fee9-3992-4915-9ba2-262b084500f9",
    "name" : "Azimuth"
  }, {
    "uuid" : "f93bf5a7-9755-4163-9c44-6d107967db4b",
    "name" : "Bit depth"
  }, {
    "uuid" : "508ac83a-8d7e-45e6-b8c7-be7aa5dccbec",
    "name" : "Bit Depth Vertical"
  }, {
    "uuid" : "6a300b55-f00c-49ff-926a-7654a18731b2",
    "name" : "Bit on Bottom"
  }, {
    "uuid" : "cbfc47a9-4bb0-4a69-9747-136b5b5fa453",
    "name" : "Block position"
  }, {
    "uuid" : "1690e9e7-3c19-4053-8788-6935a0b2d034",
    "name" : "Block Velocity"
  }, {
    "uuid" : "a3fcfa5d-8881-499d-91e8-48a7b3dc2215",
    "name" : "MWD Continuous Inclination"
  }, {
    "uuid" : "512cf80d-8872-435f-8e88-bed593b12670",
    "name" : "MWD Continuous Azimuth"
  }, {
    "uuid" : "19d0f8f5-fd1c-41f8-86c4-939a5dada63e",
    "name" : "Caliper"
  }, {
    "uuid" : "e5145f9f-e946-432c-ab0b-6bf0fbe9188c",
    "name" : "Casing Pressure"
  }, {
    "uuid" : "cc9ad146-13ae-4127-801c-4a689be7487d",
    "name" : "Choke Pressure"
  }, {
    "uuid" : "274c2682-91d7-4a31-b0e3-8928ef561f0a",
    "name" : "Circulation hours"
  }, {
    "uuid" : "b7f8a98c-e6b5-46cf-ac77-fcb2a52588f8",
    "name" : "Collar RPM"
  }, {
    "uuid" : "e1f88165-de61-4da0-be1a-ce2d9d788cf3",
    "name" : "D-exponent"
  }, {
    "uuid" : "fd5fdd95-2cd8-4879-8403-2509ee3f66ee",
    "name" : "Density"
  }, {
    "uuid" : "544e3dd7-1464-4196-825b-b4da1085e4ff",
    "name" : "Depth of Cut"
  }, {
    "uuid" : "5e3a4999-9c76-4857-8cbf-eccf51539bbf",
    "name" : "Differential Pressure"
  }, {
    "uuid" : "2fd13e54-cfb7-477a-9c56-55c20b2cadb8",
    "name" : "Dip Angle"
  }, {
    "uuid" : "15be30d7-5ade-4595-ba27-e5ce9d1bf83e",
    "name" : "Downhole MSE"
  }, {
    "uuid" : "1e96aa39-75b9-4990-8042-a02a61a08646",
    "name" : "Downhole TQ"
  }, {
    "uuid" : "627bb479-067b-4e60-b4de-7679c48c6d0f",
    "name" : "Downhole WOB"
  }, {
    "uuid" : "78b342b0-ec47-4d9b-ae3a-0df49448c1ec",
    "name" : "PWD ECD"
  }, {
    "uuid" : "992a7d4e-f854-424d-911a-c674ef8e87f4",
    "name" : "Flow Out %"
  }, {
    "uuid" : "bda8a0dd-ced2-46bd-a82a-1db75b62653c",
    "name" : "Gamma Ray"
  }, {
    "uuid" : "cf0042b1-9c10-4eca-8aa6-3954147f4fad",
    "name" : "Total Gas"
  }, {
    "uuid" : "45fbab1e-efb3-420d-9786-6f3d6f2214ed",
    "name" : "Gas C1"
  }, {
    "uuid" : "fb2bceaf-d7c6-4921-b20b-1f6152f57060",
    "name" : "Gas C2"
  }, {
    "uuid" : "643fbb3b-fe7f-4fda-a276-295fc65ceb67",
    "name" : "Gas C3"
  }, {
    "uuid" : "cb23ab73-57c3-4344-af71-4a1c60cc024c",
    "name" : "Gas C4"
  }, {
    "uuid" : "20853910-11ea-46fb-b3a7-582e63625085",
    "name" : "Gas C5"
  }, {
    "uuid" : "5525d952-8db1-4641-b2fa-18fd185b7c9d",
    "name" : "Gas CO2"
  }, {
    "uuid" : "3ed2dacd-93ac-4e38-95ed-0a7b8b82c60e",
    "name" : "Gas H2S"
  }, {
    "uuid" : "27784730-2602-4442-ac2a-9ec9822baa6c",
    "name" : "Gas iso-C4"
  }, {
    "uuid" : "4b2627a3-6a3d-4751-b818-ce1f95cb3d6a",
    "name" : "Gas iso-C5"
  }, {
    "uuid" : "ecec68ec-9a33-44c6-bedb-609b69c7f022",
    "name" : "Gas nor-C4"
  }, {
    "uuid" : "3f85640e-889e-456e-93bc-3a2a567cd5f9",
    "name" : "Gas nor-C5"
  }, {
    "uuid" : "6a5faaf0-a756-4065-99a9-d84d1fe0bfd2",
    "name" : "Gravity Total"
  }, {
    "uuid" : "f86e140e-b5d0-4b5f-98de-951200fd8038",
    "name" : "GTF"
  }, {
    "uuid" : "d635c218-3d17-4f5d-98b4-026085c4f584",
    "name" : "Hole Depth"
  }, {
    "uuid" : "2d9cbed5-4d21-4243-89e6-586f1bb961ff",
    "name" : "Hole Depth Vertical"
  }, {
    "uuid" : "dfdf09da-5be0-495f-b802-15840ce93066",
    "name" : "Hookload"
  }, {
    "uuid" : "3a655e25-ff42-4c56-b083-9d6cc77a7a8c",
    "name" : "In Slips"
  }, {
    "uuid" : "624e443b-6a3b-4247-a648-53db39d19f1b",
    "name" : "Inclination"
  }, {
    "uuid" : "b2a12c8b-dc98-4b9d-96d6-6e020736ca1b",
    "name" : "Lateral Vibration"
  }, {
    "uuid" : "b6c70cd5-aff7-4bd7-bef6-dfb663c12da9",
    "name" : "Magnetic Field"
  }, {
    "uuid" : "03c53157-8443-40d8-8ef4-087f3205da5f",
    "name" : "Motor RPM"
  }, {
    "uuid" : "805070d4-e80a-4d0d-83d6-430ba7ab00bf",
    "name" : "MTF"
  }, {
    "uuid" : "702c9494-7666-435f-ad46-9c6a3f24faa3",
    "name" : "Flow In Rate"
  }, {
    "uuid" : "65c71407-9a65-484d-aeed-b4ef14b91582",
    "name" : "Flow Out Rate"
  }, {
    "uuid" : "4457de71-ae74-4fd6-ad87-c0f19275806e",
    "name" : "Mud Weight In"
  }, {
    "uuid" : "999d98fd-b761-488f-9af8-dca909ec7bd8",
    "name" : "Mud Weight Out"
  }, {
    "uuid" : "101c98d0-2643-4b75-8012-738faa9025f7",
    "name" : "MWD Turbine RPM"
  }, {
    "uuid" : "92e27c5f-3277-4a5c-a478-b9a989944671",
    "name" : "On bottom hours"
  }, {
    "uuid" : "5f527ef9-c86b-4e55-84c0-2b8df74de1c1",
    "name" : "Oscillate status"
  }, {
    "uuid" : "b7f3fdd3-ad94-4aa4-8e94-50f5ad4dee29",
    "name" : "Pit 1 Volume"
  }, {
    "uuid" : "f1b5479f-4488-47fe-9338-12591f2d48f9",
    "name" : "Pit 2 Volume"
  }, {
    "uuid" : "e5568169-182c-466e-99e0-6957159fe08c",
    "name" : "Pit 3 Volume"
  }, {
    "uuid" : "2f03c515-d6ff-41be-b7d4-83a77c13e6c3",
    "name" : "Pit 4 Volume"
  }, {
    "uuid" : "18accea3-a188-4189-bec9-3e78a207591e",
    "name" : "Pit 5 Volume"
  }, {
    "uuid" : "cce31e79-5444-4e8d-bcae-774314ac6958",
    "name" : "Pit 6 Volume"
  }, {
    "uuid" : "278c87fd-7b22-4118-8b12-84d6474cff5d",
    "name" : "Pit 7 Volume"
  }, {
    "uuid" : "45b1afbb-6d6c-4db5-93ff-0ffa94b802da",
    "name" : "Pit 8 Volume"
  }, {
    "uuid" : "ce850617-0391-4346-8834-1449a32722df",
    "name" : "Pump 1 Cumulative Strokes"
  }, {
    "uuid" : "27a591db-8db8-4148-9115-49d5df10ac7e",
    "name" : "Pump 1 Mud Flow In"
  }, {
    "uuid" : "328949d9-a0db-41fa-9c84-4064137315c7",
    "name" : "Pump 2 Cumulative Strokes"
  }, {
    "uuid" : "5286505c-c31c-4bb8-b3c7-f0900cce9fba",
    "name" : "Pump 2 Mud Flow In"
  }, {
    "uuid" : "a3ddb237-cd23-4f5d-999f-2a3e9f6821ee",
    "name" : "Pump 3 Cumulative Strokes"
  }, {
    "uuid" : "1e15c542-3673-4140-8165-1ad534e2b3dc",
    "name" : "Pump 3 Mud Flow In"
  }, {
    "uuid" : "30ad129a-4854-4bb5-8e1d-3c9065605fe2",
    "name" : "Pump Stroke Count"
  }, {
    "uuid" : "8f46e726-06b1-4c71-b638-203868bc4451",
    "name" : "PWD Annular Pressure"
  }, {
    "uuid" : "4265ba32-99d0-490b-a1a1-b8798206a82a",
    "name" : "Rate of Penetration Instantaneous"
  }, {
    "uuid" : "c4d4b89e-5e6c-404f-9d8d-5ca8b2c26885",
    "name" : "Resistivity"
  }, {
    "uuid" : "78334ca1-783e-4dc3-9f86-c86c391d6bac",
    "name" : "Rig State"
  }, {
    "uuid" : "b68b2510-7858-4dcb-b242-57fcd584e0aa",
    "name" : "ROP"
  }, {
    "uuid" : "f4b9e8ea-ada1-4aaf-b638-064916ece1d3",
    "name" : "RSS Toolface"
  }, {
    "uuid" : "f49024eb-cdf9-42a4-beca-974dc8348281",
    "name" : "Lateral Shock"
  }, {
    "uuid" : "98e64813-b867-400a-be7c-a8f31cb56047",
    "name" : "SPM1"
  }, {
    "uuid" : "9f50ec96-0d33-46c2-8b11-c1628fe39658",
    "name" : "SPM2"
  }, {
    "uuid" : "52a79823-4947-4796-b423-545ccd8194b6",
    "name" : "SPM3"
  }, {
    "uuid" : "0f936580-1edd-449c-b760-9142097dfec6",
    "name" : "SPM Total"
  }, {
    "uuid" : "f764306b-302e-4500-8518-4f149f839a85",
    "name" : "Standpipe Pressure"
  }, {
    "uuid" : "3d1105fa-a8de-4e54-981f-105b75142937",
    "name" : "StickSlip"
  }, {
    "uuid" : "30652f8a-15d2-4a10-9e86-2943a7bd5687",
    "name" : "Surface RPM"
  }, {
    "uuid" : "de8ce461-cf26-4e38-ac68-e2e228c331ab",
    "name" : "Surface Torque"
  }, {
    "uuid" : "8b6023ce-d4d7-46be-b9e1-d9ebc92b2711",
    "name" : "Surface Torque Max"
  }, {
    "uuid" : "354dbda4-8dc0-40e8-9723-8b63b794a003",
    "name" : "Survey MD"
  }, {
    "uuid" : "7a76ccd8-e64f-4155-9184-d5f66ac3a58a",
    "name" : "Temperature In"
  }, {
    "uuid" : "9d444b75-4c6b-496c-a945-f75f003e7a0a",
    "name" : "Temperature Out"
  }, {
    "uuid" : "ac3cc40c-6055-4efa-a4fa-6a9f787bcd9d",
    "name" : "Tool Temperature"
  }, {
    "uuid" : "957a4437-2806-43d6-9b2e-2fdb612be1de",
    "name" : "Torsional Vibration"
  }, {
    "uuid" : "f0ad751b-5c66-4961-b6b9-965b282d38d8",
    "name" : "Total MSE"
  }, {
    "uuid" : "5a89a54f-3c8e-40c9-8fae-fdb7437b8adb",
    "name" : "Bit RPM"
  }, {
    "uuid" : "6565f21c-0d1e-4ce6-bbcf-da4b7900f2f4",
    "name" : "Total Tank Volume"
  }, {
    "uuid" : "86e72bb4-8f89-405b-855b-117e6fdf5f24",
    "name" : "Total Volume Active"
  }, {
    "uuid" : "92e712cc-2fe4-4ebe-967c-603828f1bea5",
    "name" : "Trip Speed"
  }, {
    "uuid" : "107b71c0-ebe1-484f-91c3-c5f57a5ee2ba",
    "name" : "Trip Tank Volume"
  }, {
    "uuid" : "7392915c-10e3-4bd0-8717-3efd4eb2943f",
    "name" : "Time of Penetration"
  }, {
    "uuid" : "5ab9a650-9ccc-4709-a76e-10d5d3ede25a",
    "name" : "RSS Steering Ratio"
  }, {
    "uuid" : "44596b6b-f833-4299-aaf7-519c7b27e8e1",
    "name" : "WOB"
  }, {
    "uuid" : "8595db67-37e0-4389-8f29-6753c9a9e2f7",
    "name" : "WOB Max"
  }, {
    "uuid" : "c1ca14ae-6d00-48cb-9c6f-f0d9840c76b1",
    "name" : "X Accelerometer"
  }, {
    "uuid" : "05c50fad-d7e0-4752-be56-9c610c86e246",
    "name" : "X Magnetometer"
  }, {
    "uuid" : "1ceca6eb-2b67-4015-8930-8f4f64578bba",
    "name" : "Y Accelerometer"
  }, {
    "uuid" : "87cbf376-966b-4252-8368-0428bbeccf7a",
    "name" : "Y Magnetometer"
  }, {
    "uuid" : "8d4a8cb5-80cc-46fa-83c6-783c21598014",
    "name" : "Z Accelerometer"
  }, {
    "uuid" : "4fbd96a1-8606-4067-8b7f-c92a4f8d777d",
    "name" : "Z Magnetometer"
  }, {
    "uuid" : "c6e1722b-2a02-4470-b2d7-bf00f5506719",
    "name" : "Depth of Cut"
  }, {
    "uuid" : "89e07b1a-d50e-4b99-ada9-023f784767d8",
    "name" : "Downhole MSE"
  }, {
    "uuid" : "a1a0e98e-9e28-438e-9c7e-254e68d0c636",
    "name" : "Total MSE"
  }, {
    "uuid" : "5d4acff6-85ea-4dd7-aac1-bbe982f7bdfc",
    "name" : "Recommended WOB"
  }, {
    "uuid" : "3ffc495e-0d17-46a5-b688-e3242884bf67",
    "name" : "Recommended RPM"
  }, {
    "uuid" : "0eef088a-ce96-4670-8b21-4b090f76d177",
    "name" : "Recommended MFI"
  }, {
    "uuid" : "68a640b5-f885-4bea-a07e-49536fa2b93d",
    "name" : "Predicted WOB"
  }, {
    "uuid" : "2d348260-372a-4e87-a8b3-82d66d95196e",
    "name" : "Predicted RPM"
  }, {
    "uuid" : "8be6cd16-906a-465c-a04d-f1fd9459458e",
    "name" : "Predicted MFI"
  }, {
    "uuid" : "027be8e3-7fcb-4fd3-b064-1f50f5c4749b",
    "name" : "Predicted ROP"
  }, {
    "uuid" : "5fe2a454-86ad-4fdc-abbf-686e4f67a4fa",
    "name" : "Trip Out: Connection"
  }, {
    "uuid" : "f65f24d3-a306-4a1c-9765-5b8359aed7c3",
    "name" : "Trip Out: Running"
  }, {
    "uuid" : "43b1d9c6-4420-4866-9c1f-c3f9d1d5f543",
    "name" : "Weight to Weight"
  }, {
    "uuid" : "e3c996b6-9cdb-4876-ac99-0aab694b801a",
    "name" : "Rig Activity"
  }, {
    "uuid" : "6906b6ba-5ad3-4df7-8176-dbc844d02d54",
    "name" : "Slide Sheet"
  }, {
    "uuid" : "0cc5b768-8a11-4e11-9ef2-135344f7b1a2",
    "name" : "RSS DLink"
  }, {
    "uuid" : "07700dd6-bdaf-477a-8b79-c48631b653d6",
    "name" : "RSS Desired TF"
  }, {
    "uuid" : "36f79b61-728b-4524-bc87-b2d97f558be2",
    "name" : "RSS Target Inclination"
  }, {
    "uuid" : "89211184-204e-4f3d-a655-bc742743ccf4",
    "name" : "RSS Target Azimuth"
  }, {
    "uuid" : "6ea4cf91-c576-4941-9515-25fec2014f6d",
    "name" : "RSS Status Word 1"
  }, {
    "uuid" : "3677c17f-bad2-44ca-95bb-6265b9898965",
    "name" : "RSS Status Word 2"
  }, {
    "uuid" : "d2271377-87d2-49b3-b40c-c4fb91d55c37",
    "name" : "RSS Status Word 3"
  }, {
    "uuid" : "b673ea0c-eee0-49b4-99ce-8bb8843365f2",
    "name" : "Zeroed WOB"
  }, {
    "uuid" : "d181ddaf-7921-476a-a45c-fc3206a07198",
    "name" : "Zeroed Differential Pressure"
  }, {
    "uuid" : "2adc5cd8-a1de-48ca-916a-3236ed6ece9a",
    "name" : "Trip Out: Reaming"
  }, {
    "uuid" : "2326a7a3-bb68-4924-a9e5-a16b7b87d192",
    "name" : "Trip In: Reaming"
  }, {
    "uuid" : "ab7e5866-a3da-4e6c-b584-523799719b34",
    "name" : "Slip to slip"
  }, {
    "uuid" : "eb85cf68-047e-43b0-bbbb-75548c8e700e",
    "name" : "Trip In: Connection"
  }, {
    "uuid" : "fed6681e-1f21-466c-bf91-55fed528a07d",
    "name" : "Trip In: Running"
  }, {
    "uuid" : "db16f0ac-2c69-4237-933d-7f6ce24fa1dc",
    "name" : "Trip In: Washing"
  }, {
    "uuid" : "08e28406-7ade-4fb2-8dca-1628936f2b36",
    "name" : "Trip Out: Washing"
  }, {
    "uuid" : "4545b4f1-4f71-41aa-86c3-b87961459f5f",
    "name" : "Rotary Build Rate"
  }, {
    "uuid" : "1f0a45f4-1b62-11f0-902e-77c4b3b98667",
    "name" : "Rotary Turn Rate"
  }, {
    "uuid" : "f09337a9-ca89-411d-a2e6-aad17746b4ee",
    "name" : "Slack off & Drag"
  }, {
    "uuid" : "bf7c700d-de08-41c5-b20b-cb32d649d8e8",
    "name" : "Erratic Torque"
  }, {
    "uuid" : "f0519265-7a47-488a-978a-24997705844e",
    "name" : "Time from Last Connection"
  }, {
    "uuid" : "7136da25-7a78-4558-864e-8dd21623fbe9",
    "name" : "Time From Last Survey"
  }, {
    "uuid" : "b9e0a067-ab3a-4e59-8ec6-c14f33346df4",
    "name" : "Time On Bottom"
  }, {
    "uuid" : "69471b8a-c20a-449e-abc9-0147adaf6d14",
    "name" : "Static Time"
  }, {
    "uuid" : "265d885d-567d-4d27-843e-c9fa39800c1d",
    "name" : "Time to top"
  }, {
    "uuid" : "ef5b8413-dcec-4c4c-b607-6b4200142f7d",
    "name" : "Forecast Confidence"
  }, {
    "uuid" : "11b703b5-b0d2-43c5-a370-d509a9d4604b",
    "name" : "Drill Zone"
  }, {
    "uuid" : "44161596-6117-47bc-ae86-05561b38c773",
    "name" : "Recommended ROP"
  }, {
    "uuid" : "261cea68-1b62-11f0-8a2e-cbc9b8e5e876",
    "name" : "Motor Yield"
  }, {
    "uuid" : "11584aba-59fb-4a81-a12e-cf52e1d819c5",
    "name" : "KPI: Pumps On to Bottom"
  }, {
    "uuid" : "4e2f64a1-eaf9-4d7f-9e3f-616c68084bfd",
    "name" : "KPI: On Bottom to Slips"
  }, {
    "uuid" : "3084fd0c-0ea0-42b6-8024-768c8c26566d",
    "name" : "KPI: Slips to On Bottom"
  }, {
    "uuid" : "9a81e86b-2e78-4d23-87bb-b76232df40f2",
    "name" : "Motor Stall"
  }, {
    "uuid" : "01851a5a-9071-43df-86fc-673655c8f211",
    "name" : "RSS Continuous Azimuth"
  }, {
    "uuid" : "c7d0f834-b1cf-437f-94a6-ca8f07a1f8c9",
    "name" : "RSS Continious Inclination"
  }, {
    "uuid" : "5b30ffb3-2cbe-46ed-a9ec-87c5582ae1eb",
    "name" : "Rig State"
  } ]
}

GET /public/api/v1/traces

Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array System traces (including robot-calculated ones such as Rig Activity) and custom traces of the user's company
content[].uuid String Trace UUID
content[].name String Trace name

Get mapped time traces by lateral

Get the list of traces mapped to a lateral. type=TIME returns time traces: WITSML-mapped traces and robot-calculated point traces that have time data. type=CALC returns all robot-calculated traces of the lateral with their hash and time range, without unit and null_value

Request

$ curl 'https://solo.cloud/public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/mapped?type=TIME' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/mapped?type=TIME HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3796381e39ba2278aa424a861980979d
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "30652f8a-15d2-4a10-9e86-2943a7bd5687",
    "name" : "Surface RPM",
    "hash" : "a82fbfd1a0af724a7e5f7a5e409a2842",
    "unit" : "1/s",
    "null_value" : "-999.25",
    "start_date_time_index" : "2020-12-29T08:00:00Z",
    "last_date_time_index" : "2020-12-29T08:50:00Z"
  }, {
    "uuid" : "702c9494-7666-435f-ad46-9c6a3f24faa3",
    "name" : "Flow In Rate",
    "hash" : "0bab876d633be26eedf68650e51f1a85",
    "unit" : "m3/s",
    "null_value" : "-999.25",
    "start_date_time_index" : "2020-12-29T08:00:00Z",
    "last_date_time_index" : "2020-12-29T08:50:00Z"
  }, {
    "uuid" : "d635c218-3d17-4f5d-98b4-026085c4f584",
    "name" : "Hole Depth",
    "hash" : "ea31ba012a1cdfebd6296708646d0126",
    "unit" : "m",
    "null_value" : "-999.25",
    "start_date_time_index" : "2020-12-29T08:00:00Z",
    "last_date_time_index" : "2020-12-29T08:50:00Z"
  }, {
    "uuid" : "dfdf09da-5be0-495f-b802-15840ce93066",
    "name" : "Hookload",
    "hash" : "64750d5bb464c8b25748eda042f8ef26",
    "unit" : "N",
    "null_value" : "-999.25",
    "start_date_time_index" : "2020-12-29T08:00:00Z",
    "last_date_time_index" : "2020-12-29T08:50:00Z"
  }, {
    "uuid" : "f93bf5a7-9755-4163-9c44-6d107967db4b",
    "name" : "Bit depth",
    "hash" : "3122a98d2b66368f7482679c643f3bf7",
    "unit" : "m",
    "null_value" : "-999.25",
    "start_date_time_index" : "2020-12-29T08:00:00Z",
    "last_date_time_index" : "2020-12-29T08:50:00Z"
  } ]
}

GET /public/api/v1/wells/{uuid}/traces/mapped

Path parameter Description
uuid Lateral UUID
Parameter Description
type Trace type: TIME - mapped time traces (WITSML-mapped traces and robot-calculated point traces that have time data), CALC - all robot-calculated traces of the lateral (Rig Activity, KPIs, Slide Sheet, point traces), returned without unit and null_value
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Mapped traces
content[].uuid String Trace UUID
content[].name String Trace name
content[].hash String Hash of the current trace mapping, can be passed as hash to the trace data endpoints
content[].unit String UOM of the trace values: UOM of the mapped curve, base SI unit for robot-calculated traces
content[].null_value String Null value of the mapped curve
content[].start_date_time_index String Date time of the first data point, absent when there is no data
content[].last_date_time_index String Date time of the last data point, absent when there is no data

Get mapped depth traces by lateral

Get the list of depth traces mapped to a lateral: WITSML-mapped traces and robot-calculated point traces that have depth data. Depth values of a trace are in its index_unit, not in project units

Request

$ curl 'https://solo.cloud/public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/mapped?type=DEPTH' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/mapped?type=DEPTH HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 449509fd757a1d97c0eb02ca31f435d8
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "d635c218-3d17-4f5d-98b4-026085c4f584",
    "name" : "Hole Depth",
    "hash" : "53eadf1f5ae09501e86ac2eb437f05b6",
    "unit" : "m",
    "index_unit" : "m",
    "null_value" : "-999.25",
    "start_depth_index" : 1.0,
    "last_depth_index" : 4.0
  } ]
}

GET /public/api/v1/wells/{uuid}/traces/mapped

Path parameter Description
uuid Lateral UUID
Parameter Description
type Trace type: DEPTH - mapped depth traces (WITSML-mapped traces and robot-calculated point traces that have depth data)
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Mapped traces
content[].uuid String Trace UUID
content[].name String Trace name
content[].hash String Hash of the current trace mapping, can be passed as hash to the trace data endpoints
content[].unit String UOM of the trace values: UOM of the mapped curve, base SI unit for robot-calculated traces
content[].index_unit String Depth index UOM of the mapped curve (m for robot-calculated traces). start_depth_index, last_depth_index and the depth data from/to are in this UOM, not in project units
content[].null_value String Null value of the mapped curve
content[].start_depth_index Number Depth of the first data point in index_unit, absent when there is no data
content[].last_depth_index Number Depth of the last data point in index_unit, absent when there is no data

Get time series data by lateral and trace

Get time series data of a mapped trace by lateral UUID and trace UUID. The requested range is clipped to the trace data range, a range outside of it returns an empty content. Points are sorted by time, at most limit points are returned. 404 is returned if the trace has no time mapping on the lateral or hash does not match

Request

$ curl 'https://solo.cloud/public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/d635c218-3d17-4f5d-98b4-026085c4f584/data/time?from=2020-12-29T08%3A00%3A00Z&to=2020-12-29T08%3A50%3A00Z' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/d635c218-3d17-4f5d-98b4-026085c4f584/data/time?from=2020-12-29T08%3A00%3A00Z&to=2020-12-29T08%3A50%3A00Z HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 2f83caa120470ef187b75ea3206cd74d
Content-Type: application/json

{
  "content" : [ {
    "index" : "2020-12-29T08:00:00.000Z",
    "value" : "20341.2"
  }, {
    "index" : "2020-12-29T08:00:01.000Z",
    "value" : "20341.2"
  }, {
    "index" : "2020-12-29T08:00:02.000Z",
    "value" : "20341.2"
  }, {
    "index" : "2020-12-29T08:00:03.000Z",
    "value" : "20341.2"
  }, {
    "index" : "2020-12-29T08:00:04.000Z",
    "value" : "20341.2"
  }, {
    "index" : "2020-12-29T08:00:05.000Z",
    "value" : "20341.2"
  }, {
    "index" : "2020-12-29T08:00:06.000Z",
    "value" : "20341.2"
  }, {
    "index" : "2020-12-29T08:00:07.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:08.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:09.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:10.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:11.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:12.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:13.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:14.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:15.000Z",
    "value" : "20341.3"
  }, {
    "index" : "2020-12-29T08:00:16.000Z",
    "value" : "20341.4"
  }, {
    "index" : "2020-12-29T08:00:17.000Z",
    "value" : "20341.4"
  }, {
    "index" : "2020-12-29T08:00:18.000Z",
    "value" : "20341.4"
  }, {
    "index" : "2020-12-29T08:00:19.000Z",
    "value" : "20341.4"
  }, {
    "index" : "2020-12-29T08:00:20.000Z",
    "value" : "20341.4"
  }, {
    "index" : "2020-12-29T08:00:21.000Z",
    "value" : "20341.4"
  }, {
    "index" : "2020-12-29T08:00:22.000Z",
    "value" : "20341.5"
  }, {
    "index" : "2020-12-29T08:00:23.000Z",
    "value" : "20341.5"
  }, {
    "index" : "2020-12-29T08:00:24.000Z",
    "value" : "20341.5"
  }, {
    "index" : "2020-12-29T08:00:25.000Z",
    "value" : "20341.5"
  }, {
    "index" : "2020-12-29T08:00:26.000Z",
    "value" : "20341.5"
  }, {
    "index" : "2020-12-29T08:00:27.000Z",
    "value" : "20341.5"
  }, {
    "index" : "2020-12-29T08:00:28.000Z",
    "value" : "20341.6"
  }, {
    "index" : "2020-12-29T08:00:29.000Z",
    "value" : "20341.6"
  }, {
    "index" : "2020-12-29T08:00:30.000Z",
    "value" : "20341.6"
  }, {
    "index" : "2020-12-29T08:00:31.000Z",
    "value" : "20341.6"
  }, {
    "index" : "2020-12-29T08:00:32.000Z",
    "value" : "20341.6"
  }, {
    "index" : "2020-12-29T08:00:33.000Z",
    "value" : "20341.6"
  }, {
    "index" : "2020-12-29T08:00:34.000Z",
    "value" : "20341.6"
  }, {
    "index" : "2020-12-29T08:00:35.000Z",
    "value" : "20341.6"
  }, {
    "index" : "2020-12-29T08:00:36.000Z",
    "value" : "20341.7"
  }, {
    "index" : "2020-12-29T08:00:37.000Z",
    "value" : "20341.7"
  }, {
    "index" : "2020-12-29T08:00:38.000Z",
    "value" : "20341.7"
  }, {
    "index" : "2020-12-29T08:00:39.000Z",
    "value" : "20341.7"
  }, {
    "index" : "2020-12-29T08:00:40.000Z",
    "value" : "20341.7"
  }, {
    "index" : "2020-12-29T08:00:41.000Z",
    "value" : "20341.7"
  }, {
    "index" : "2020-12-29T08:00:42.000Z",
    "value" : "20341.7"
  }, {
    "index" : "2020-12-29T08:00:43.000Z",
    "value" : "20341.8"
  }, {
    "index" : "2020-12-29T08:00:44.000Z",
    "value" : "20341.8"
  }, {
    "index" : "2020-12-29T08:00:45.000Z",
    "value" : "20341.8"
  }, {
    "index" : "2020-12-29T08:00:46.000Z",
    "value" : "20341.8"
  }, {
    "index" : "2020-12-29T08:00:47.000Z",
    "value" : "20341.8"
  }, {
    "index" : "2020-12-29T08:00:48.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:49.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:50.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:51.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:52.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:53.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:54.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:55.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:56.000Z",
    "value" : "20341.9"
  }, {
    "index" : "2020-12-29T08:00:57.000Z",
    "value" : "20342"
  }, {
    "index" : "2020-12-29T08:00:58.000Z",
    "value" : "20342"
  }, {
    "index" : "2020-12-29T08:00:59.000Z",
    "value" : "20342"
  }, {
    "index" : "2020-12-29T08:01:00.000Z",
    "value" : "20342"
  }, {
    "index" : "2020-12-29T08:01:01.000Z",
    "value" : "20342"
  }, {
    "index" : "2020-12-29T08:01:02.000Z",
    "value" : "20342"
  }, {
    "index" : "2020-12-29T08:01:03.000Z",
    "value" : "20342"
  }, {
    "index" : "2020-12-29T08:01:04.000Z",
    "value" : "20342"
  }, {
    "index" : "2020-12-29T08:01:05.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:06.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:07.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:08.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:09.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:10.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:11.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:12.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:13.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:14.000Z",
    "value" : "20342.1"
  }, {
    "index" : "2020-12-29T08:01:15.000Z",
    "value" : "20342.2"
  }, {
    "index" : "2020-12-29T08:01:16.000Z",
    "value" : "20342.2"
  }, {
    "index" : "2020-12-29T08:01:17.000Z",
    "value" : "20342.2"
  }, {
    "index" : "2020-12-29T08:01:18.000Z",
    "value" : "20342.2"
  }, {
    "index" : "2020-12-29T08:01:19.000Z",
    "value" : "20342.2"
  }, {
    "index" : "2020-12-29T08:01:20.000Z",
    "value" : "20342.2"
  }, {
    "index" : "2020-12-29T08:01:21.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:22.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:23.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:24.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:25.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:26.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:27.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:28.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:29.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:30.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:31.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:32.000Z",
    "value" : "20342.3"
  }, {
    "index" : "2020-12-29T08:01:33.000Z",
    "value" : "20342.4"
  }, {
    "index" : "2020-12-29T08:01:34.000Z",
    "value" : "20342.4"
  }, {
    "index" : "2020-12-29T08:01:35.000Z",
    "value" : "20342.4"
  }, {
    "index" : "2020-12-29T08:01:36.000Z",
    "value" : "20342.4"
  }, {
    "index" : "2020-12-29T08:01:37.000Z",
    "value" : "20342.4"
  }, {
    "index" : "2020-12-29T08:01:38.000Z",
    "value" : "20342.4"
  }, {
    "index" : "2020-12-29T08:01:39.000Z",
    "value" : "20342.4"
  }, {
    "index" : "2020-12-29T08:01:40.000Z",
    "value" : "20342.4"
  }, {
    "index" : "2020-12-29T08:01:41.000Z",
    "value" : "20342.5"
  }, {
    "index" : "2020-12-29T08:01:42.000Z",
    "value" : "20342.5"
  }, {
    "index" : "2020-12-29T08:01:43.000Z",
    "value" : "20342.5"
  }, {
    "index" : "2020-12-29T08:01:44.000Z",
    "value" : "20342.5"
  }, {
    "index" : "2020-12-29T08:01:45.000Z",
    "value" : "20342.5"
  }, {
    "index" : "2020-12-29T08:01:46.000Z",
    "value" : "20342.5"
  }, {
    "index" : "2020-12-29T08:01:47.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:48.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:49.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:50.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:51.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:52.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:53.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:54.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:55.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:56.000Z",
    "value" : "20342.6"
  }, {
    "index" : "2020-12-29T08:01:57.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:01:58.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:01:59.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:00.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:01.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:02.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:03.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:04.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:05.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:06.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:07.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:08.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:09.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:10.000Z",
    "value" : "20342.7"
  }, {
    "index" : "2020-12-29T08:02:11.000Z",
    "value" : "20342.8"
  }, {
    "index" : "2020-12-29T08:02:12.000Z",
    "value" : "20342.8"
  }, {
    "index" : "2020-12-29T08:02:13.000Z",
    "value" : "20342.8"
  }, {
    "index" : "2020-12-29T08:02:14.000Z",
    "value" : "20342.8"
  }, {
    "index" : "2020-12-29T08:02:15.000Z",
    "value" : "20342.8"
  }, {
    "index" : "2020-12-29T08:02:16.000Z",
    "value" : "20342.8"
  }, {
    "index" : "2020-12-29T08:02:17.000Z",
    "value" : "20342.8"
  }, {
    "index" : "2020-12-29T08:02:18.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:19.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:20.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:21.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:22.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:23.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:24.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:25.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:26.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:27.000Z",
    "value" : "20342.9"
  }, {
    "index" : "2020-12-29T08:02:28.000Z",
    "value" : "20343"
  }, {
    "index" : "2020-12-29T08:02:29.000Z",
    "value" : "20343"
  }, {
    "index" : "2020-12-29T08:02:30.000Z",
    "value" : "20343"
  }, {
    "index" : "2020-12-29T08:02:31.000Z",
    "value" : "20343"
  }, {
    "index" : "2020-12-29T08:02:32.000Z",
    "value" : "20343"
  }, {
    "index" : "2020-12-29T08:02:33.000Z",
    "value" : "20343"
  }, {
    "index" : "2020-12-29T08:02:34.000Z",
    "value" : "20343"
  }, {
    "index" : "2020-12-29T08:02:35.000Z",
    "value" : "20343.1"
  }, {
    "index" : "2020-12-29T08:02:36.000Z",
    "value" : "20343.1"
  }, {
    "index" : "2020-12-29T08:02:37.000Z",
    "value" : "20343.1"
  }, {
    "index" : "2020-12-29T08:02:38.000Z",
    "value" : "20343.1"
  }, {
    "index" : "2020-12-29T08:02:39.000Z",
    "value" : "20343.1"
  }, {
    "index" : "2020-12-29T08:02:40.000Z",
    "value" : "20343.1"
  }, {
    "index" : "2020-12-29T08:02:41.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:42.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:43.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:44.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:45.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:46.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:47.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:48.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:49.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:50.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:51.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:52.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:53.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:54.000Z",
    "value" : "20343.2"
  }, {
    "index" : "2020-12-29T08:02:55.000Z",
    "value" : "20343.3"
  }, {
    "index" : "2020-12-29T08:02:56.000Z",
    "value" : "20343.3"
  }, {
    "index" : "2020-12-29T08:02:57.000Z",
    "value" : "20343.3"
  }, {
    "index" : "2020-12-29T08:02:58.000Z",
    "value" : "20343.3"
  }, {
    "index" : "2020-12-29T08:02:59.000Z",
    "value" : "20343.4"
  }, {
    "index" : "2020-12-29T08:03:00.000Z",
    "value" : "20343.4"
  }, {
    "index" : "2020-12-29T08:03:01.000Z",
    "value" : "20343.5"
  }, {
    "index" : "2020-12-29T08:03:02.000Z",
    "value" : "20343.5"
  }, {
    "index" : "2020-12-29T08:03:03.000Z",
    "value" : "20343.5"
  }, {
    "index" : "2020-12-29T08:03:04.000Z",
    "value" : "20343.6"
  }, {
    "index" : "2020-12-29T08:03:05.000Z",
    "value" : "20343.6"
  }, {
    "index" : "2020-12-29T08:03:06.000Z",
    "value" : "20343.6"
  }, {
    "index" : "2020-12-29T08:03:07.000Z",
    "value" : "20343.7"
  }, {
    "index" : "2020-12-29T08:03:08.000Z",
    "value" : "20343.7"
  }, {
    "index" : "2020-12-29T08:03:09.000Z",
    "value" : "20343.7"
  }, {
    "index" : "2020-12-29T08:03:10.000Z",
    "value" : "20343.7"
  }, {
    "index" : "2020-12-29T08:03:11.000Z",
    "value" : "20343.8"
  }, {
    "index" : "2020-12-29T08:03:12.000Z",
    "value" : "20343.8"
  }, {
    "index" : "2020-12-29T08:03:13.000Z",
    "value" : "20343.8"
  }, {
    "index" : "2020-12-29T08:03:14.000Z",
    "value" : "20343.8"
  }, {
    "index" : "2020-12-29T08:03:15.000Z",
    "value" : "20343.8"
  }, {
    "index" : "2020-12-29T08:03:16.000Z",
    "value" : "20343.8"
  }, {
    "index" : "2020-12-29T08:03:17.000Z",
    "value" : "20343.8"
  }, {
    "index" : "2020-12-29T08:03:18.000Z",
    "value" : "20343.8"
  }, {
    "index" : "2020-12-29T08:03:19.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:20.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:21.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:22.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:23.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:24.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:25.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:26.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:27.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:28.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:29.000Z",
    "value" : "20343.9"
  }, {
    "index" : "2020-12-29T08:03:30.000Z",
    "value" : "20344"
  }, {
    "index" : "2020-12-29T08:03:31.000Z",
    "value" : "20344"
  }, {
    "index" : "2020-12-29T08:03:32.000Z",
    "value" : "20344"
  }, {
    "index" : "2020-12-29T08:03:33.000Z",
    "value" : "20344"
  }, {
    "index" : "2020-12-29T08:03:34.000Z",
    "value" : "20344"
  }, {
    "index" : "2020-12-29T08:03:35.000Z",
    "value" : "20344"
  }, {
    "index" : "2020-12-29T08:03:36.000Z",
    "value" : "20344.1"
  }, {
    "index" : "2020-12-29T08:03:37.000Z",
    "value" : "20344.1"
  }, {
    "index" : "2020-12-29T08:03:38.000Z",
    "value" : "20344.1"
  }, {
    "index" : "2020-12-29T08:03:39.000Z",
    "value" : "20344.1"
  }, {
    "index" : "2020-12-29T08:03:40.000Z",
    "value" : "20344.1"
  }, {
    "index" : "2020-12-29T08:03:41.000Z",
    "value" : "20344.1"
  }, {
    "index" : "2020-12-29T08:03:42.000Z",
    "value" : "20344.2"
  }, {
    "index" : "2020-12-29T08:03:43.000Z",
    "value" : "20344.2"
  }, {
    "index" : "2020-12-29T08:03:44.000Z",
    "value" : "20344.2"
  }, {
    "index" : "2020-12-29T08:03:45.000Z",
    "value" : "20344.2"
  }, {
    "index" : "2020-12-29T08:03:46.000Z",
    "value" : "20344.2"
  }, {
    "index" : "2020-12-29T08:03:47.000Z",
    "value" : "20344.2"
  }, {
    "index" : "2020-12-29T08:03:48.000Z",
    "value" : "20344.2"
  }, {
    "index" : "2020-12-29T08:03:49.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:50.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:51.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:52.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:53.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:54.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:55.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:56.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:57.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:58.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:03:59.000Z",
    "value" : "20344.3"
  }, {
    "index" : "2020-12-29T08:04:00.000Z",
    "value" : "20344.4"
  }, {
    "index" : "2020-12-29T08:04:01.000Z",
    "value" : "20344.4"
  }, {
    "index" : "2020-12-29T08:04:02.000Z",
    "value" : "20344.4"
  }, {
    "index" : "2020-12-29T08:04:03.000Z",
    "value" : "20344.4"
  }, {
    "index" : "2020-12-29T08:04:04.000Z",
    "value" : "20344.4"
  }, {
    "index" : "2020-12-29T08:04:05.000Z",
    "value" : "20344.5"
  }, {
    "index" : "2020-12-29T08:04:06.000Z",
    "value" : "20344.5"
  }, {
    "index" : "2020-12-29T08:04:07.000Z",
    "value" : "20344.5"
  }, {
    "index" : "2020-12-29T08:04:08.000Z",
    "value" : "20344.5"
  }, {
    "index" : "2020-12-29T08:04:09.000Z",
    "value" : "20344.5"
  }, {
    "index" : "2020-12-29T08:04:10.000Z",
    "value" : "20344.5"
  }, {
    "index" : "2020-12-29T08:04:11.000Z",
    "value" : "20344.6"
  }, {
    "index" : "2020-12-29T08:04:12.000Z",
    "value" : "20344.6"
  }, {
    "index" : "2020-12-29T08:04:13.000Z",
    "value" : "20344.6"
  }, {
    "index" : "2020-12-29T08:04:14.000Z",
    "value" : "20344.6"
  }, {
    "index" : "2020-12-29T08:04:15.000Z",
    "value" : "20344.6"
  }, {
    "index" : "2020-12-29T08:04:16.000Z",
    "value" : "20344.6"
  }, {
    "index" : "2020-12-29T08:04:17.000Z",
    "value" : "20344.6"
  }, {
    "index" : "2020-12-29T08:04:18.000Z",
    "value" : "20344.7"
  }, {
    "index" : "2020-12-29T08:04:19.000Z",
    "value" : "20344.7"
  }, {
    "index" : "2020-12-29T08:04:20.000Z",
    "value" : "20344.7"
  }, {
    "index" : "2020-12-29T08:04:21.000Z",
    "value" : "20344.7"
  }, {
    "index" : "2020-12-29T08:04:22.000Z",
    "value" : "20344.7"
  }, {
    "index" : "2020-12-29T08:04:23.000Z",
    "value" : "20344.7"
  }, {
    "index" : "2020-12-29T08:04:24.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:25.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:26.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:27.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:28.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:29.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:30.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:31.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:32.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:33.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:34.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:35.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:36.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:37.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:38.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:39.000Z",
    "value" : "20344.8"
  }, {
    "index" : "2020-12-29T08:04:40.000Z",
    "value" : "20344.9"
  }, {
    "index" : "2020-12-29T08:04:41.000Z",
    "value" : "20344.9"
  }, {
    "index" : "2020-12-29T08:04:42.000Z",
    "value" : "20344.9"
  }, {
    "index" : "2020-12-29T08:04:43.000Z",
    "value" : "20344.9"
  }, {
    "index" : "2020-12-29T08:04:44.000Z",
    "value" : "20345"
  }, {
    "index" : "2020-12-29T08:04:45.000Z",
    "value" : "20345"
  }, {
    "index" : "2020-12-29T08:04:46.000Z",
    "value" : "20345"
  }, {
    "index" : "2020-12-29T08:04:47.000Z",
    "value" : "20345"
  }, {
    "index" : "2020-12-29T08:04:48.000Z",
    "value" : "20345"
  }, {
    "index" : "2020-12-29T08:04:49.000Z",
    "value" : "20345"
  }, {
    "index" : "2020-12-29T08:04:50.000Z",
    "value" : "20345"
  }, {
    "index" : "2020-12-29T08:04:51.000Z",
    "value" : "20345"
  }, {
    "index" : "2020-12-29T08:04:52.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:04:53.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:04:54.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:04:55.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:04:56.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:04:57.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:04:58.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:04:59.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:05:00.000Z",
    "value" : "20345.1"
  }, {
    "index" : "2020-12-29T08:05:01.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:02.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:03.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:04.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:05.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:06.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:07.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:08.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:09.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:10.000Z",
    "value" : "20345.2"
  }, {
    "index" : "2020-12-29T08:05:11.000Z",
    "value" : "20345.3"
  }, {
    "index" : "2020-12-29T08:05:12.000Z",
    "value" : "20345.3"
  }, {
    "index" : "2020-12-29T08:05:13.000Z",
    "value" : "20345.3"
  }, {
    "index" : "2020-12-29T08:05:14.000Z",
    "value" : "20345.3"
  }, {
    "index" : "2020-12-29T08:05:15.000Z",
    "value" : "20345.3"
  }, {
    "index" : "2020-12-29T08:05:16.000Z",
    "value" : "20345.3"
  }, {
    "index" : "2020-12-29T08:05:17.000Z",
    "value" : "20345.3"
  }, {
    "index" : "2020-12-29T08:05:18.000Z",
    "value" : "20345.3"
  }, {
    "index" : "2020-12-29T08:05:19.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:20.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:21.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:22.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:23.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:24.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:25.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:26.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:27.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:28.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:29.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:30.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:31.000Z",
    "value" : "20345.4"
  }, {
    "index" : "2020-12-29T08:05:32.000Z",
    "value" : "20345.5"
  }, {
    "index" : "2020-12-29T08:05:33.000Z",
    "value" : "20345.5"
  }, {
    "index" : "2020-12-29T08:05:34.000Z",
    "value" : "20345.5"
  }, {
    "index" : "2020-12-29T08:05:35.000Z",
    "value" : "20345.5"
  }, {
    "index" : "2020-12-29T08:05:36.000Z",
    "value" : "20345.5"
  }, {
    "index" : "2020-12-29T08:05:37.000Z",
    "value" : "20345.5"
  }, {
    "index" : "2020-12-29T08:05:38.000Z",
    "value" : "20345.6"
  }, {
    "index" : "2020-12-29T08:05:39.000Z",
    "value" : "20345.6"
  }, {
    "index" : "2020-12-29T08:05:40.000Z",
    "value" : "20345.6"
  }, {
    "index" : "2020-12-29T08:05:41.000Z",
    "value" : "20345.6"
  }, {
    "index" : "2020-12-29T08:05:42.000Z",
    "value" : "20345.6"
  }, {
    "index" : "2020-12-29T08:05:43.000Z",
    "value" : "20345.6"
  }, {
    "index" : "2020-12-29T08:05:44.000Z",
    "value" : "20345.6"
  }, {
    "index" : "2020-12-29T08:05:45.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:46.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:47.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:48.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:49.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:50.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:51.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:52.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:53.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:54.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:55.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:56.000Z",
    "value" : "20345.7"
  }, {
    "index" : "2020-12-29T08:05:57.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:05:58.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:05:59.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:06:00.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:06:01.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:06:02.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:06:03.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:06:04.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:06:05.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:06:06.000Z",
    "value" : "20345.8"
  }, {
    "index" : "2020-12-29T08:06:07.000Z",
    "value" : "20345.9"
  }, {
    "index" : "2020-12-29T08:06:08.000Z",
    "value" : "20345.9"
  }, {
    "index" : "2020-12-29T08:06:09.000Z",
    "value" : "20345.9"
  }, {
    "index" : "2020-12-29T08:06:10.000Z",
    "value" : "20345.9"
  }, {
    "index" : "2020-12-29T08:06:11.000Z",
    "value" : "20345.9"
  }, {
    "index" : "2020-12-29T08:06:12.000Z",
    "value" : "20345.9"
  }, {
    "index" : "2020-12-29T08:06:13.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:14.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:15.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:16.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:17.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:18.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:19.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:20.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:21.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:22.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:23.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:24.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:25.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:26.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:27.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:28.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:29.000Z",
    "value" : "20346"
  }, {
    "index" : "2020-12-29T08:06:30.000Z",
    "value" : "20346.1"
  }, {
    "index" : "2020-12-29T08:06:31.000Z",
    "value" : "20346.1"
  }, {
    "index" : "2020-12-29T08:06:32.000Z",
    "value" : "20346.1"
  }, {
    "index" : "2020-12-29T08:06:33.000Z",
    "value" : "20346.1"
  }, {
    "index" : "2020-12-29T08:06:34.000Z",
    "value" : "20346.1"
  }, {
    "index" : "2020-12-29T08:06:35.000Z",
    "value" : "20346.1"
  }, {
    "index" : "2020-12-29T08:06:36.000Z",
    "value" : "20346.2"
  }, {
    "index" : "2020-12-29T08:06:37.000Z",
    "value" : "20346.2"
  }, {
    "index" : "2020-12-29T08:06:38.000Z",
    "value" : "20346.2"
  }, {
    "index" : "2020-12-29T08:06:39.000Z",
    "value" : "20346.2"
  }, {
    "index" : "2020-12-29T08:06:40.000Z",
    "value" : "20346.2"
  }, {
    "index" : "2020-12-29T08:06:41.000Z",
    "value" : "20346.2"
  }, {
    "index" : "2020-12-29T08:06:42.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:43.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:44.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:45.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:46.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:47.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:48.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:49.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:50.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:51.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:52.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:53.000Z",
    "value" : "20346.3"
  }, {
    "index" : "2020-12-29T08:06:54.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:06:55.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:06:56.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:06:57.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:06:58.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:06:59.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:00.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:01.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:02.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:03.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:04.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:05.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:06.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:07.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:08.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:09.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:10.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:11.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:12.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:13.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:14.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:15.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:16.000Z",
    "value" : "20346.4"
  }, {
    "index" : "2020-12-29T08:07:17.000Z",
    "value" : "20346.5"
  }, {
    "index" : "2020-12-29T08:07:18.000Z",
    "value" : "20346.5"
  }, {
    "index" : "2020-12-29T08:07:19.000Z",
    "value" : "20346.5"
  }, {
    "index" : "2020-12-29T08:07:20.000Z",
    "value" : "20346.6"
  }, {
    "index" : "2020-12-29T08:07:21.000Z",
    "value" : "20346.6"
  }, {
    "index" : "2020-12-29T08:07:22.000Z",
    "value" : "20346.6"
  }, {
    "index" : "2020-12-29T08:07:23.000Z",
    "value" : "20346.6"
  }, {
    "index" : "2020-12-29T08:07:24.000Z",
    "value" : "20346.6"
  }, {
    "index" : "2020-12-29T08:07:25.000Z",
    "value" : "20346.6"
  }, {
    "index" : "2020-12-29T08:07:26.000Z",
    "value" : "20346.7"
  }, {
    "index" : "2020-12-29T08:07:27.000Z",
    "value" : "20346.7"
  }, {
    "index" : "2020-12-29T08:07:28.000Z",
    "value" : "20346.7"
  }, {
    "index" : "2020-12-29T08:07:29.000Z",
    "value" : "20346.7"
  }, {
    "index" : "2020-12-29T08:07:30.000Z",
    "value" : "20346.7"
  }, {
    "index" : "2020-12-29T08:07:31.000Z",
    "value" : "20346.7"
  }, {
    "index" : "2020-12-29T08:07:32.000Z",
    "value" : "20346.7"
  }, {
    "index" : "2020-12-29T08:07:33.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:34.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:35.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:36.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:37.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:38.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:39.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:40.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:41.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:42.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:43.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:44.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:45.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:46.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:47.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:48.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:49.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:50.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:51.000Z",
    "value" : "20346.8"
  }, {
    "index" : "2020-12-29T08:07:52.000Z",
    "value" : "20346.9"
  }, {
    "index" : "2020-12-29T08:07:53.000Z",
    "value" : "20346.9"
  }, {
    "index" : "2020-12-29T08:07:54.000Z",
    "value" : "20346.9"
  }, {
    "index" : "2020-12-29T08:07:55.000Z",
    "value" : "20346.9"
  }, {
    "index" : "2020-12-29T08:07:56.000Z",
    "value" : "20347"
  }, {
    "index" : "2020-12-29T08:07:57.000Z",
    "value" : "20347"
  }, {
    "index" : "2020-12-29T08:07:58.000Z",
    "value" : "20347"
  }, {
    "index" : "2020-12-29T08:07:59.000Z",
    "value" : "20347"
  }, {
    "index" : "2020-12-29T08:08:00.000Z",
    "value" : "20347"
  }, {
    "index" : "2020-12-29T08:08:01.000Z",
    "value" : "20347.1"
  }, {
    "index" : "2020-12-29T08:08:02.000Z",
    "value" : "20347.1"
  }, {
    "index" : "2020-12-29T08:08:03.000Z",
    "value" : "20347.1"
  }, {
    "index" : "2020-12-29T08:08:04.000Z",
    "value" : "20347.1"
  }, {
    "index" : "2020-12-29T08:08:05.000Z",
    "value" : "20347.1"
  }, {
    "index" : "2020-12-29T08:08:06.000Z",
    "value" : "20347.1"
  }, {
    "index" : "2020-12-29T08:08:07.000Z",
    "value" : "20347.2"
  }, {
    "index" : "2020-12-29T08:08:08.000Z",
    "value" : "20347.2"
  }, {
    "index" : "2020-12-29T08:08:09.000Z",
    "value" : "20347.2"
  }, {
    "index" : "2020-12-29T08:08:30.000Z",
    "value" : "20347.4"
  }, {
    "index" : "2020-12-29T08:08:31.000Z",
    "value" : "20347.5"
  }, {
    "index" : "2020-12-29T08:08:32.000Z",
    "value" : "20347.5"
  }, {
    "index" : "2020-12-29T08:08:33.000Z",
    "value" : "20347.5"
  }, {
    "index" : "2020-12-29T08:08:34.000Z",
    "value" : "20347.5"
  }, {
    "index" : "2020-12-29T08:08:35.000Z",
    "value" : "20347.5"
  }, {
    "index" : "2020-12-29T08:08:36.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:37.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:38.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:39.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:40.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:41.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:42.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:43.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:44.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:45.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:46.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:47.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:48.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:49.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:50.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:51.000Z",
    "value" : "20347.6"
  }, {
    "index" : "2020-12-29T08:08:52.000Z",
    "value" : "20347.7"
  }, {
    "index" : "2020-12-29T08:08:53.000Z",
    "value" : "20347.7"
  }, {
    "index" : "2020-12-29T08:08:54.000Z",
    "value" : "20347.7"
  }, {
    "index" : "2020-12-29T08:08:55.000Z",
    "value" : "20347.7"
  }, {
    "index" : "2020-12-29T08:08:56.000Z",
    "value" : "20347.7"
  }, {
    "index" : "2020-12-29T08:08:57.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:08:58.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:08:59.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:09:00.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:09:01.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:09:02.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:09:03.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:09:04.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:09:05.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:09:06.000Z",
    "value" : "20347.8"
  }, {
    "index" : "2020-12-29T08:09:07.000Z",
    "value" : "20347.9"
  }, {
    "index" : "2020-12-29T08:09:08.000Z",
    "value" : "20347.9"
  }, {
    "index" : "2020-12-29T08:09:09.000Z",
    "value" : "20347.9"
  }, {
    "index" : "2020-12-29T08:09:10.000Z",
    "value" : "20347.9"
  }, {
    "index" : "2020-12-29T08:09:11.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:12.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:13.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:14.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:15.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:16.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:17.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:18.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:19.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:20.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:21.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:22.000Z",
    "value" : "20348"
  }, {
    "index" : "2020-12-29T08:09:23.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:24.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:25.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:26.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:27.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:28.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:29.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:30.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:31.000Z",
    "value" : "20348.1"
  }, {
    "index" : "2020-12-29T08:09:32.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:33.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:34.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:35.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:36.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:37.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:38.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:39.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:40.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:41.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:42.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:43.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:44.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:45.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:46.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:47.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:48.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:49.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:50.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:51.000Z",
    "value" : "20348.2"
  }, {
    "index" : "2020-12-29T08:09:52.000Z",
    "value" : "20348.3"
  }, {
    "index" : "2020-12-29T08:09:53.000Z",
    "value" : "20348.3"
  }, {
    "index" : "2020-12-29T08:09:54.000Z",
    "value" : "20348.3"
  }, {
    "index" : "2020-12-29T08:09:55.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:09:56.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:09:57.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:09:58.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:09:59.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:10:00.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:10:01.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:10:02.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:10:03.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:10:04.000Z",
    "value" : "20348.4"
  }, {
    "index" : "2020-12-29T08:10:05.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:06.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:07.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:08.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:09.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:10.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:11.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:12.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:13.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:14.000Z",
    "value" : "20348.5"
  }, {
    "index" : "2020-12-29T08:10:15.000Z",
    "value" : "20348.6"
  }, {
    "index" : "2020-12-29T08:10:16.000Z",
    "value" : "20348.6"
  }, {
    "index" : "2020-12-29T08:10:17.000Z",
    "value" : "20348.6"
  }, {
    "index" : "2020-12-29T08:10:18.000Z",
    "value" : "20348.6"
  }, {
    "index" : "2020-12-29T08:10:19.000Z",
    "value" : "20348.6"
  }, {
    "index" : "2020-12-29T08:10:20.000Z",
    "value" : "20348.6"
  }, {
    "index" : "2020-12-29T08:10:21.000Z",
    "value" : "20348.6"
  }, {
    "index" : "2020-12-29T08:10:22.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:23.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:24.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:25.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:26.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:27.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:28.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:29.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:30.000Z",
    "value" : "20348.7"
  }, {
    "index" : "2020-12-29T08:10:31.000Z",
    "value" : "20348.8"
  }, {
    "index" : "2020-12-29T08:10:32.000Z",
    "value" : "20348.8"
  }, {
    "index" : "2020-12-29T08:10:33.000Z",
    "value" : "20348.8"
  }, {
    "index" : "2020-12-29T08:10:34.000Z",
    "value" : "20348.8"
  }, {
    "index" : "2020-12-29T08:10:35.000Z",
    "value" : "20348.8"
  }, {
    "index" : "2020-12-29T08:10:36.000Z",
    "value" : "20348.8"
  }, {
    "index" : "2020-12-29T08:10:37.000Z",
    "value" : "20348.8"
  }, {
    "index" : "2020-12-29T08:10:38.000Z",
    "value" : "20348.8"
  }, {
    "index" : "2020-12-29T08:10:39.000Z",
    "value" : "20348.9"
  }, {
    "index" : "2020-12-29T08:10:40.000Z",
    "value" : "20348.9"
  }, {
    "index" : "2020-12-29T08:10:41.000Z",
    "value" : "20348.9"
  }, {
    "index" : "2020-12-29T08:10:42.000Z",
    "value" : "20348.9"
  }, {
    "index" : "2020-12-29T08:10:43.000Z",
    "value" : "20348.9"
  }, {
    "index" : "2020-12-29T08:10:44.000Z",
    "value" : "20348.9"
  }, {
    "index" : "2020-12-29T08:10:45.000Z",
    "value" : "20348.9"
  }, {
    "index" : "2020-12-29T08:10:46.000Z",
    "value" : "20349"
  }, {
    "index" : "2020-12-29T08:10:47.000Z",
    "value" : "20349"
  }, {
    "index" : "2020-12-29T08:10:48.000Z",
    "value" : "20349"
  }, {
    "index" : "2020-12-29T08:10:49.000Z",
    "value" : "20349"
  }, {
    "index" : "2020-12-29T08:10:50.000Z",
    "value" : "20349"
  }, {
    "index" : "2020-12-29T08:10:51.000Z",
    "value" : "20349"
  }, {
    "index" : "2020-12-29T08:10:52.000Z",
    "value" : "20349"
  }, {
    "index" : "2020-12-29T08:10:53.000Z",
    "value" : "20349"
  }, {
    "index" : "2020-12-29T08:10:54.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:10:55.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:10:56.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:10:57.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:10:58.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:10:59.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:00.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:01.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:02.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:03.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:04.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:05.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:06.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:07.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:08.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:09.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:10.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:11.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:12.000Z",
    "value" : "20349.1"
  }, {
    "index" : "2020-12-29T08:11:13.000Z",
    "value" : "20349.2"
  }, {
    "index" : "2020-12-29T08:11:14.000Z",
    "value" : "20349.2"
  }, {
    "index" : "2020-12-29T08:11:15.000Z",
    "value" : "20349.2"
  }, {
    "index" : "2020-12-29T08:11:16.000Z",
    "value" : "20349.2"
  }, {
    "index" : "2020-12-29T08:11:17.000Z",
    "value" : "20349.2"
  }, {
    "index" : "2020-12-29T08:11:18.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:19.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:20.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:21.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:22.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:23.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:24.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:25.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:26.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:27.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:28.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:29.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:30.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:31.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:32.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:33.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:34.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:35.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:36.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:37.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:38.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:39.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:40.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:41.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:42.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:43.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:44.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:45.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:46.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:47.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:48.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:49.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:50.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:51.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:52.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:53.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:54.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:55.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:56.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:57.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:58.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:11:59.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:00.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:01.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:02.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:03.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:04.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:05.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:06.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:07.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:08.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:09.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:10.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:11.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:12.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:13.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:14.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:15.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:16.000Z",
    "value" : "20349.3"
  }, {
    "index" : "2020-12-29T08:12:17.000Z",
    "value" : "20349.4"
  }, {
    "index" : "2020-12-29T08:12:18.000Z",
    "value" : "20349.4"
  }, {
    "index" : "2020-12-29T08:12:19.000Z",
    "value" : "20349.4"
  }, {
    "index" : "2020-12-29T08:12:20.000Z",
    "value" : "20349.5"
  }, {
    "index" : "2020-12-29T08:12:21.000Z",
    "value" : "20349.5"
  }, {
    "index" : "2020-12-29T08:12:22.000Z",
    "value" : "20349.5"
  }, {
    "index" : "2020-12-29T08:12:23.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:24.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:25.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:26.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:27.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:28.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:29.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:30.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:31.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:32.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:33.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:34.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:35.000Z",
    "value" : "20349.6"
  }, {
    "index" : "2020-12-29T08:12:36.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:37.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:38.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:39.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:40.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:41.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:42.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:43.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:44.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:45.000Z",
    "value" : "20349.7"
  }, {
    "index" : "2020-12-29T08:12:46.000Z",
    "value" : "20349.8"
  }, {
    "index" : "2020-12-29T08:12:47.000Z",
    "value" : "20349.8"
  }, {
    "index" : "2020-12-29T08:12:48.000Z",
    "value" : "20349.8"
  }, {
    "index" : "2020-12-29T08:12:49.000Z",
    "value" : "20349.9"
  }, {
    "index" : "2020-12-29T08:12:50.000Z",
    "value" : "20349.9"
  }, {
    "index" : "2020-12-29T08:12:51.000Z",
    "value" : "20349.9"
  }, {
    "index" : "2020-12-29T08:12:52.000Z",
    "value" : "20349.9"
  }, {
    "index" : "2020-12-29T08:12:53.000Z",
    "value" : "20349.9"
  }, {
    "index" : "2020-12-29T08:12:54.000Z",
    "value" : "20349.9"
  }, {
    "index" : "2020-12-29T08:12:55.000Z",
    "value" : "20349.9"
  }, {
    "index" : "2020-12-29T08:12:56.000Z",
    "value" : "20349.9"
  }, {
    "index" : "2020-12-29T08:12:57.000Z",
    "value" : "20350"
  }, {
    "index" : "2020-12-29T08:12:58.000Z",
    "value" : "20350"
  }, {
    "index" : "2020-12-29T08:12:59.000Z",
    "value" : "20350"
  }, {
    "index" : "2020-12-29T08:13:00.000Z",
    "value" : "20350"
  }, {
    "index" : "2020-12-29T08:13:01.000Z",
    "value" : "20350"
  }, {
    "index" : "2020-12-29T08:13:02.000Z",
    "value" : "20350"
  }, {
    "index" : "2020-12-29T08:13:03.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:04.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:05.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:06.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:07.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:08.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:09.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:10.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:11.000Z",
    "value" : "20350.1"
  }, {
    "index" : "2020-12-29T08:13:12.000Z",
    "value" : "20350.2"
  }, {
    "index" : "2020-12-29T08:13:13.000Z",
    "value" : "20350.2"
  }, {
    "index" : "2020-12-29T08:13:14.000Z",
    "value" : "20350.2"
  }, {
    "index" : "2020-12-29T08:13:15.000Z",
    "value" : "20350.2"
  }, {
    "index" : "2020-12-29T08:13:16.000Z",
    "value" : "20350.2"
  }, {
    "index" : "2020-12-29T08:13:17.000Z",
    "value" : "20350.2"
  }, {
    "index" : "2020-12-29T08:13:18.000Z",
    "value" : "20350.2"
  }, {
    "index" : "2020-12-29T08:13:19.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:20.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:21.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:22.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:23.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:24.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:25.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:26.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:27.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:28.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:29.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:30.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:31.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:32.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:33.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:34.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:35.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:36.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:37.000Z",
    "value" : "20350.3"
  }, {
    "index" : "2020-12-29T08:13:38.000Z",
    "value" : "20350.4"
  }, {
    "index" : "2020-12-29T08:13:39.000Z",
    "value" : "20350.4"
  }, {
    "index" : "2020-12-29T08:13:40.000Z",
    "value" : "20350.4"
  }, {
    "index" : "2020-12-29T08:13:41.000Z",
    "value" : "20350.4"
  }, {
    "index" : "2020-12-29T08:13:42.000Z",
    "value" : "20350.5"
  }, {
    "index" : "2020-12-29T08:13:43.000Z",
    "value" : "20350.5"
  }, {
    "index" : "2020-12-29T08:13:44.000Z",
    "value" : "20350.5"
  }, {
    "index" : "2020-12-29T08:13:45.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:46.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:47.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:48.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:49.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:50.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:51.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:52.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:53.000Z",
    "value" : "20350.6"
  }, {
    "index" : "2020-12-29T08:13:54.000Z",
    "value" : "20350.7"
  }, {
    "index" : "2020-12-29T08:13:55.000Z",
    "value" : "20350.7"
  }, {
    "index" : "2020-12-29T08:13:56.000Z",
    "value" : "20350.7"
  }, {
    "index" : "2020-12-29T08:13:57.000Z",
    "value" : "20350.7"
  }, {
    "index" : "2020-12-29T08:13:58.000Z",
    "value" : "20350.7"
  }, {
    "index" : "2020-12-29T08:13:59.000Z",
    "value" : "20350.7"
  }, {
    "index" : "2020-12-29T08:14:00.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:01.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:02.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:03.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:04.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:05.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:06.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:07.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:08.000Z",
    "value" : "20350.8"
  }, {
    "index" : "2020-12-29T08:14:09.000Z",
    "value" : "20350.9"
  }, {
    "index" : "2020-12-29T08:14:10.000Z",
    "value" : "20350.9"
  }, {
    "index" : "2020-12-29T08:14:11.000Z",
    "value" : "20350.9"
  }, {
    "index" : "2020-12-29T08:14:12.000Z",
    "value" : "20350.9"
  }, {
    "index" : "2020-12-29T08:14:13.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:14.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:15.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:16.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:17.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:18.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:19.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:20.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:21.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:22.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:23.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:24.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:25.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:26.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:27.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:28.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:29.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:30.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:31.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:32.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:33.000Z",
    "value" : "20351"
  }, {
    "index" : "2020-12-29T08:14:34.000Z",
    "value" : "20351.1"
  }, {
    "index" : "2020-12-29T08:14:35.000Z",
    "value" : "20351.1"
  }, {
    "index" : "2020-12-29T08:14:36.000Z",
    "value" : "20351.1"
  }, {
    "index" : "2020-12-29T08:14:37.000Z",
    "value" : "20351.1"
  }, {
    "index" : "2020-12-29T08:14:38.000Z",
    "value" : "20351.1"
  }, {
    "index" : "2020-12-29T08:14:39.000Z",
    "value" : "20351.2"
  }, {
    "index" : "2020-12-29T08:14:40.000Z",
    "value" : "20351.2"
  }, {
    "index" : "2020-12-29T08:14:41.000Z",
    "value" : "20351.2"
  }, {
    "index" : "2020-12-29T08:14:42.000Z",
    "value" : "20351.3"
  }, {
    "index" : "2020-12-29T08:14:43.000Z",
    "value" : "20351.3"
  }, {
    "index" : "2020-12-29T08:14:44.000Z",
    "value" : "20351.3"
  }, {
    "index" : "2020-12-29T08:14:45.000Z",
    "value" : "20351.4"
  }, {
    "index" : "2020-12-29T08:14:46.000Z",
    "value" : "20351.4"
  }, {
    "index" : "2020-12-29T08:14:47.000Z",
    "value" : "20351.4"
  }, {
    "index" : "2020-12-29T08:14:48.000Z",
    "value" : "20351.5"
  }, {
    "index" : "2020-12-29T08:14:49.000Z",
    "value" : "20351.5"
  }, {
    "index" : "2020-12-29T08:14:50.000Z",
    "value" : "20351.5"
  }, {
    "index" : "2020-12-29T08:14:51.000Z",
    "value" : "20351.6"
  }, {
    "index" : "2020-12-29T08:14:52.000Z",
    "value" : "20351.6"
  }, {
    "index" : "2020-12-29T08:14:53.000Z",
    "value" : "20351.7"
  }, {
    "index" : "2020-12-29T08:14:54.000Z",
    "value" : "20351.7"
  }, {
    "index" : "2020-12-29T08:14:55.000Z",
    "value" : "20351.7"
  }, {
    "index" : "2020-12-29T08:14:56.000Z",
    "value" : "20351.7"
  }, {
    "index" : "2020-12-29T08:14:57.000Z",
    "value" : "20351.8"
  }, {
    "index" : "2020-12-29T08:14:58.000Z",
    "value" : "20351.8"
  }, {
    "index" : "2020-12-29T08:14:59.000Z",
    "value" : "20351.9"
  }, {
    "index" : "2020-12-29T08:15:00.000Z",
    "value" : "20351.9"
  }, {
    "index" : "2020-12-29T08:15:01.000Z",
    "value" : "20351.9"
  }, {
    "index" : "2020-12-29T08:15:02.000Z",
    "value" : "20352"
  }, {
    "index" : "2020-12-29T08:15:03.000Z",
    "value" : "20352"
  }, {
    "index" : "2020-12-29T08:15:04.000Z",
    "value" : "20352"
  }, {
    "index" : "2020-12-29T08:15:05.000Z",
    "value" : "20352"
  }, {
    "index" : "2020-12-29T08:15:06.000Z",
    "value" : "20352.1"
  }, {
    "index" : "2020-12-29T08:15:07.000Z",
    "value" : "20352.1"
  }, {
    "index" : "2020-12-29T08:15:08.000Z",
    "value" : "20352.1"
  }, {
    "index" : "2020-12-29T08:15:09.000Z",
    "value" : "20352.2"
  }, {
    "index" : "2020-12-29T08:15:10.000Z",
    "value" : "20352.2"
  }, {
    "index" : "2020-12-29T08:15:11.000Z",
    "value" : "20352.2"
  }, {
    "index" : "2020-12-29T08:15:12.000Z",
    "value" : "20352.2"
  }, {
    "index" : "2020-12-29T08:15:13.000Z",
    "value" : "20352.2"
  }, {
    "index" : "2020-12-29T08:15:14.000Z",
    "value" : "20352.3"
  }, {
    "index" : "2020-12-29T08:15:15.000Z",
    "value" : "20352.3"
  }, {
    "index" : "2020-12-29T08:15:16.000Z",
    "value" : "20352.3"
  }, {
    "index" : "2020-12-29T08:15:17.000Z",
    "value" : "20352.3"
  }, {
    "index" : "2020-12-29T08:15:18.000Z",
    "value" : "20352.4"
  }, {
    "index" : "2020-12-29T08:15:19.000Z",
    "value" : "20352.4"
  }, {
    "index" : "2020-12-29T08:15:20.000Z",
    "value" : "20352.4"
  }, {
    "index" : "2020-12-29T08:15:21.000Z",
    "value" : "20352.4"
  }, {
    "index" : "2020-12-29T08:15:22.000Z",
    "value" : "20352.4"
  }, {
    "index" : "2020-12-29T08:15:23.000Z",
    "value" : "20352.5"
  }, {
    "index" : "2020-12-29T08:15:24.000Z",
    "value" : "20352.5"
  }, {
    "index" : "2020-12-29T08:15:25.000Z",
    "value" : "20352.5"
  }, {
    "index" : "2020-12-29T08:15:26.000Z",
    "value" : "20352.5"
  }, {
    "index" : "2020-12-29T08:15:27.000Z",
    "value" : "20352.5"
  }, {
    "index" : "2020-12-29T08:15:28.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:29.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:30.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:31.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:32.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:33.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:34.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:35.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:36.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:37.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:38.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:39.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:40.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:41.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:42.000Z",
    "value" : "20352.6"
  }, {
    "index" : "2020-12-29T08:15:43.000Z",
    "value" : "20352.7"
  }, {
    "index" : "2020-12-29T08:15:44.000Z",
    "value" : "20352.7"
  }, {
    "index" : "2020-12-29T08:15:45.000Z",
    "value" : "20352.7"
  }, {
    "index" : "2020-12-29T08:15:46.000Z",
    "value" : "20352.7"
  }, {
    "index" : "2020-12-29T08:15:47.000Z",
    "value" : "20352.8"
  }, {
    "index" : "2020-12-29T08:15:48.000Z",
    "value" : "20352.8"
  }, {
    "index" : "2020-12-29T08:15:49.000Z",
    "value" : "20352.8"
  }, {
    "index" : "2020-12-29T08:15:50.000Z",
    "value" : "20352.8"
  }, {
    "index" : "2020-12-29T08:15:51.000Z",
    "value" : "20352.8"
  }, {
    "index" : "2020-12-29T08:15:52.000Z",
    "value" : "20352.9"
  }, {
    "index" : "2020-12-29T08:15:53.000Z",
    "value" : "20352.9"
  }, {
    "index" : "2020-12-29T08:15:54.000Z",
    "value" : "20352.9"
  }, {
    "index" : "2020-12-29T08:15:55.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:15:56.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:15:57.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:15:58.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:15:59.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:00.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:01.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:02.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:03.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:04.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:05.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:06.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:07.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:08.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:09.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:10.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:11.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:12.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:13.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:14.000Z",
    "value" : "20353"
  }, {
    "index" : "2020-12-29T08:16:15.000Z",
    "value" : "20353.1"
  }, {
    "index" : "2020-12-29T08:16:16.000Z",
    "value" : "20353.1"
  }, {
    "index" : "2020-12-29T08:16:17.000Z",
    "value" : "20353.1"
  }, {
    "index" : "2020-12-29T08:16:18.000Z",
    "value" : "20353.2"
  }, {
    "index" : "2020-12-29T08:16:19.000Z",
    "value" : "20353.2"
  }, {
    "index" : "2020-12-29T08:16:20.000Z",
    "value" : "20353.2"
  }, {
    "index" : "2020-12-29T08:16:21.000Z",
    "value" : "20353.2"
  }, {
    "index" : "2020-12-29T08:16:22.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:23.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:24.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:25.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:26.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:27.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:28.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:29.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:30.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:31.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:32.000Z",
    "value" : "20353.3"
  }, {
    "index" : "2020-12-29T08:16:33.000Z",
    "value" : "20353.4"
  }, {
    "index" : "2020-12-29T08:16:34.000Z",
    "value" : "20353.4"
  }, {
    "index" : "2020-12-29T08:16:35.000Z",
    "value" : "20353.4"
  }, {
    "index" : "2020-12-29T08:16:36.000Z",
    "value" : "20353.4"
  }, {
    "index" : "2020-12-29T08:16:37.000Z",
    "value" : "20353.4"
  }, {
    "index" : "2020-12-29T08:16:38.000Z",
    "value" : "20353.4"
  }, {
    "index" : "2020-12-29T08:16:39.000Z",
    "value" : "20353.4"
  }, {
    "index" : "2020-12-29T08:16:40.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:41.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:42.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:43.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:44.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:45.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:46.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:47.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:48.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:49.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:50.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:51.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:52.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:53.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:54.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:55.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:56.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:57.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:58.000Z",
    "value" : "20353.5"
  }, {
    "index" : "2020-12-29T08:16:59.000Z",
    "value" : "20353.6"
  } ]
}

GET /public/api/v1/wells/{lateralUuid}/traces/{traceUuid}/data/time

Path parameter Description
lateralUuid Lateral UUID
traceUuid Trace UUID
Parameter Description
from Optional. Start date, for example: 2020-11-01T00:00:00.000Z. Default - the first data point of the trace
to Optional. End date, for example: 2020-11-01T00:02:00.000Z. Default - the last data point of the trace. from after to returns 400
hash Optional. Trace hash from the mapped traces response. 404 is returned if it does not match the current mapping
valueUnit Optional. UOM symbol to convert the values to, for example ft. 400 is returned if it is not convertible from the trace unit, ignored when the trace has no unit
limit Optional. Maximum number of points to return, in [1;1000000], default 1000. Points are returned in ascending time order starting from from
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Trace data points
content[].index String Date time of the point
content[].value String Trace value in the trace unit, or in valueUnit if set

Get depth series data by lateral and trace

Get depth series data of a mapped trace by lateral UUID and trace UUID. from, to and the returned index are in the trace index_unit (see Get mapped depth traces by lateral), indexUnit and valueUnit convert the returned indexes and values. The requested range is clipped to the trace data range, a range outside of it returns an empty content. Points are sorted by depth, at most limit points are returned. 404 is returned if the trace has no depth mapping on the lateral or hash does not match

Request

$ curl 'https://solo.cloud/public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/d635c218-3d17-4f5d-98b4-026085c4f584/data/depth?from=1.0&to=4.0' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/d635c218-3d17-4f5d-98b4-026085c4f584/data/depth?from=1.0&to=4.0 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3b7945a2a7f6d7491e4c9ec0dbb95d9a
Content-Type: application/json

{
  "content" : [ {
    "index" : "1",
    "value" : "10"
  }, {
    "index" : "2",
    "value" : "20"
  }, {
    "index" : "3",
    "value" : "30"
  }, {
    "index" : "4",
    "value" : "40"
  } ]
}

GET /public/api/v1/wells/{lateralUuid}/traces/{traceUuid}/data/depth

Path parameter Description
lateralUuid Lateral UUID
traceUuid Trace UUID
Parameter Description
from Optional. Start md in the trace index_unit (see mapped depth traces), for example: 0.0. Default - the first data point of the trace
to Optional. End md in the trace index_unit, for example: 2300. Default - the last data point of the trace. from greater than to returns 400
hash Optional. Trace hash from the mapped traces response. 404 is returned if it does not match the current mapping
indexUnit Optional. Length UOM symbol to convert the returned index values to, for example ft. from and to are not converted
valueUnit Optional. UOM symbol to convert the values to. 400 is returned if it is not convertible from the trace unit, ignored when the trace has no unit
limit Optional. Maximum number of points to return, in [1;1000000], default 1000. Points are returned in ascending depth order starting from from
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Trace data points
content[].index String Md of the point in the trace index_unit, or in indexUnit if set
content[].value String Trace value in the trace unit, or in valueUnit if set

Get Rig Activity and KPIs (by time) by lateral and trace

Get intervals of a robot-calculated trace (Rig Activity, KPIs, etc.) by lateral UUID and trace UUID. All intervals overlapping the requested time range are returned, sorted by start time, without paging. The range defaults to the trace data range. 404 is returned if the trace is not mapped to the lateral or hash does not match. For Rig Activity value is the rig activity code: 0 In Slips, 11 In Slips - Pump, 21 Drilling, 22 Slide Drill, 23 Slide Oscillate Drill, 31 Reaming, 32 Back Reaming, 50 Static, 51 Static - Rotate&Pump, 52 Static - Pump, 53 Static - Rotate, 54 Surface Operations, 61 Run In - Tripping, 62 Run In - Pump, 63 Run In - Rotate, 64 Pull Up - Pump, 65 Pull Up - Rotate, 66 Pull Up - Trip Out, 98 Unknown, 99 Missing Input

Request

$ curl 'https://solo.cloud/public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/e3c996b6-9cdb-4876-ac99-0aab694b801a/data/calculated/time' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/e3c996b6-9cdb-4876-ac99-0aab694b801a/data/calculated/time HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: b5519f407912b4de2751f26201fd96fe
Content-Type: application/json

{
  "content" : [ {
    "start" : "2020-11-01T00:00:00Z",
    "end" : "2020-11-01T01:00:02Z",
    "value" : "21"
  }, {
    "start" : "2020-12-29T08:00:00Z",
    "end" : "2020-12-29T08:50:00Z",
    "value" : "21"
  } ]
}

GET /public/api/v1/wells/{lateralUuid}/traces/{traceUuid}/data/calculated/time

Path parameter Description
lateralUuid Lateral UUID
traceUuid Robot-calculated trace UUID
Parameter Description
from Optional. Start date, for example: 2020-11-01T00:00:00.000Z. Default - the start of the trace data
to Optional. End date, for example: 2020-11-01T00:02:00.000Z. Default - the end of the trace data. from after to returns 400
hash Optional. Trace hash from the mapped traces response (type=CALC). 404 is returned if it does not match the current mapping
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Intervals overlapping the requested time range, sorted by start time
content[].start String Interval start date time
content[].end String Interval end date time
content[].value String Interval value, for Rig Activity - the rig activity code

Get Rig Activity and KPIs (by depth) by lateral and trace

Get intervals of a robot-calculated trace by lateral UUID and trace UUID whose depth range overlaps from-to, sorted by start depth, without paging. from, to, start and end are in meters regardless of the project unit. Intervals without depth are not returned. 404 is returned if the trace is not mapped to the lateral or hash does not match

Request

$ curl 'https://solo.cloud/public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/e3c996b6-9cdb-4876-ac99-0aab694b801a/data/calculated/depth?from=1.0&to=10.0' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/54e17078-d342-4b8b-a123-96662e0360bc/traces/e3c996b6-9cdb-4876-ac99-0aab694b801a/data/calculated/depth?from=1.0&to=10.0 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: bf4f8c3f460ace7a362cd93e47c61707
Content-Type: application/json

{
  "content" : [ {
    "start" : 1.0,
    "end" : 10.0,
    "value" : "21"
  } ]
}

GET /public/api/v1/wells/{lateralUuid}/traces/{traceUuid}/data/calculated/depth

Path parameter Description
lateralUuid Lateral UUID
traceUuid Robot-calculated trace UUID
Parameter Description
from Start depth in meters, regardless of the project unit
to End depth in meters. from greater than to returns 400
hash Optional. Trace hash from the mapped traces response (type=CALC). 404 is returned if it does not match the current mapping
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Intervals whose depth range overlaps the requested range, intervals without depth are not returned
content[].start Number Interval start depth in meters
content[].end Number Interval end depth in meters
content[].value String Interval value, for Rig Activity - the rig activity code

14. Directional Drilling

Get slide sheet intervals

Get Slide Sheet robot intervals by lateral UUID whose depth range overlaps from-to (project depth units), sorted by start depth, without paging. Depths and lengths are returned in project depth units, angles in degrees, other values in the units listed in the response fields. Intervals without slide sheet data are not returned. An empty content is returned if the lateral has no Slide Sheet data

Request

$ curl 'https://solo.cloud/public/api/v1/wells/3602d63d-19fd-4abc-b277-d688d6f8bebf/intervals/slide-sheet?from=200.0&to=500.0' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/3602d63d-19fd-4abc-b277-d688d6f8bebf/intervals/slide-sheet?from=200.0&to=500.0 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 8efd5fe5726d3b4ba3c81b635da31271
Content-Type: application/json

{
  "content" : [ {
    "depth_from" : 407.8224,
    "depth_to" : 421.15130400000004,
    "from" : "2023-04-25T03:00:15Z",
    "to" : "2023-04-25T03:12:37Z",
    "mode" : "ROTARY",
    "distance" : 13.328904000000023,
    "rop_avg" : 64.66853692722383,
    "mfi_avg" : 37.97616657081958,
    "diff_pressure_avg" : 28.50240282152303,
    "rpm_avg" : 40.55567116396066
  }, {
    "depth_from" : 421.15130400000004,
    "depth_to" : 426.579792,
    "from" : "2023-04-25T03:18:17Z",
    "to" : "2023-04-25T03:22:35Z",
    "mode" : "ROTARY",
    "distance" : 5.428487999999959,
    "rop_avg" : 75.74634418604595,
    "mfi_avg" : 44.301426562745654,
    "diff_pressure_avg" : 27.84057092289668,
    "rpm_avg" : 40.826889387984245
  }, {
    "depth_from" : 426.579792,
    "depth_to" : 433.09946400000007,
    "from" : "2023-04-25T03:31:29Z",
    "to" : "2023-04-25T03:40:34Z",
    "mode" : "SLIDE",
    "distance" : 6.519672000000071,
    "rop_avg" : 43.065723302752765,
    "mfi_avg" : 44.29881991412529,
    "diff_pressure_avg" : 18.090786997094895,
    "rpm_avg" : 0.11454885460497963,
    "gtf_avg" : -4188.322087125122,
    "mtf_avg" : 12844.874388918157
  }, {
    "depth_from" : 433.09946400000007,
    "depth_to" : 449.61962400000004,
    "from" : "2023-04-25T03:41:42Z",
    "to" : "2023-04-25T03:53:30Z",
    "mode" : "ROTARY",
    "distance" : 16.520159999999976,
    "rop_avg" : 84.00081355932191,
    "mfi_avg" : 44.29301571640074,
    "diff_pressure_avg" : 36.554082604907975,
    "rpm_avg" : 40.80610147601478
  }, {
    "depth_from" : 449.61962400000004,
    "depth_to" : 454.758552,
    "from" : "2023-04-25T03:59:48Z",
    "to" : "2023-04-25T04:02:40Z",
    "mode" : "ROTARY",
    "distance" : 5.138927999999964,
    "rop_avg" : 107.55895813953414,
    "mfi_avg" : 56.44465664867975,
    "diff_pressure_avg" : 34.757457553000386,
    "rpm_avg" : 60.42781138790041
  }, {
    "depth_from" : 454.758552,
    "depth_to" : 455.983848,
    "from" : "2023-04-25T04:04:08Z",
    "to" : "2023-04-25T04:06:15Z",
    "mode" : "SLIDE",
    "distance" : 1.2252960000000144,
    "rop_avg" : 34.73280000000041,
    "mfi_avg" : 56.48777290420894,
    "diff_pressure_avg" : 13.452906542095633,
    "rpm_avg" : 0.1718407960196003,
    "gtf_avg" : -4188.322087125122,
    "mtf_avg" : 12177.835638050661,
    "rotary_build_rate" : -33.10848744832925,
    "rotary_turn_rate" : -17.52802276676857,
    "motor_yield" : 212205.26330565757
  }, {
    "depth_from" : 455.99604,
    "depth_to" : 460.711296,
    "from" : "2023-04-25T04:06:15Z",
    "to" : "2023-04-25T04:11:22Z",
    "mode" : "OSCILLATION_SLIDE",
    "distance" : 4.715256000000011,
    "rop_avg" : 55.29290423452781,
    "mfi_avg" : 56.677411506534895,
    "diff_pressure_avg" : 21.57243815705851,
    "rpm_avg" : 6.967925016160347,
    "gtf_avg" : -4188.322087125122,
    "mtf_avg" : 14358.09873929123,
    "tf_control" : 7850.0,
    "burned_distance" : 3.4,
    "survey_md" : 1274.8155148800001,
    "incl" : 5193.290204884008,
    "azimuth" : 20604.1382455686
  } ]
}

GET /public/api/v1/wells/{lateralUuid}/intervals/slide-sheet

Path parameter Description
lateralUuid Lateral UUID
Parameter Description
from Optional. Start depth in project depth units, default - no lower bound
to Optional. End depth in project depth units, default - no upper bound. from greater than to returns 400
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Slide sheet intervals whose depth range overlaps the requested range
content[].depth_from Number Interval start depth in project depth units
content[].depth_to Number Interval end depth in project depth units
content[].from String Interval start time
content[].to String Interval end time
content[].mode String Drilling mode: ROTARY, SLIDE, OSCILLATION_SLIDE, MANUAL_TF, POWER_V, IH, HIA or AUTO_CURVE
content[].distance Number Distance drilled in project depth units
content[].rop_avg Number Average rate of penetration, m/h in meter projects, ft/h otherwise
content[].wob_avg Number Average weight on bit in the project force unit template if set, otherwise tonf[metric] in meter projects and klbf otherwise
content[].mfi_avg Number Average mud flow in, in the project flow rate unit template if set, otherwise L/s in meter projects and gal[US]/min otherwise
content[].diff_pressure_avg Number Average differential pressure in the project pressure unit template if set, otherwise atm in meter projects and psi otherwise
content[].rpm_avg Number Average rotary speed, RPM
content[].gtf_avg Number Average gravity tool face, degrees
content[].mtf_avg Number Average magnetic tool face, degrees
content[].gtf_effective Number Effective gravity tool face, degrees
content[].tf_control Number Tool face control, %
content[].burned_distance Number Burned distance in project depth units
content[].survey_md Number Survey measured depth in project depth units
content[].incl Number Inclination, degrees
content[].azimuth Number Azimuth, degrees
content[].tvd Number True vertical depth in project depth units
content[].dls Number Dog leg severity, deg/30m in meter projects, deg/100ft otherwise
content[].rotary_build_rate Number Rotary build rate, deg/30m in meter projects, deg/100ft otherwise
content[].rotary_turn_rate Number Rotary turn rate, deg/30m in meter projects, deg/100ft otherwise
content[].motor_yield Number Motor yield, deg/30m in meter projects, deg/100ft otherwise
content[].rss_dlink String RSS D-link
content[].rss_dtf Number RSS DTF, degrees
content[].rss_sr Number RSS steering ratio
content[].rss_tinc Number RSS target inclination, degrees
content[].rss_taz Number RSS target azimuth, degrees

15. Well attributes

Create custom well attribute

Create a custom well attribute by project UUID. name, type and group_uuid are required. A name already used in the project returns 400. For a LIST-type attribute initial options can be passed in the options field. An IDENTIFIER-type attribute holds a string value that must be unique within the project (see the update value endpoints for the conflict behavior)

Request

$ curl 'https://solo.cloud/public/api/v1/projects/708be72a-8f5b-4cf5-9e0c-005b6565e45e/wellattributes' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Custom attribute name",
  "group_uuid" : "caeb5bb2-18ea-4191-9c36-f2e252259371",
  "type" : "VARCHAR",
  "unit" : "DISTANCE"
}'

POST /public/api/v1/projects/708be72a-8f5b-4cf5-9e0c-005b6565e45e/wellattributes HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 140

{
  "name" : "Custom attribute name",
  "group_uuid" : "caeb5bb2-18ea-4191-9c36-f2e252259371",
  "type" : "VARCHAR",
  "unit" : "DISTANCE"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f12230948f09631b7a826e56a5656491
Content-Type: application/json

{
  "id" : 10005,
  "uuid" : "6b5a4c4d-bab8-4eec-a4cd-b51b4331492d",
  "name" : "Custom attribute name"
}

POST /public/api/v1/projects/{projectUuid}/wellattributes

Path parameter Description
projectUuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Well attribute name, up to 200 characters, unique (case-insensitive) among the project's custom and the predefined attributes
name_short String Well attribute short name, up to 200 characters, defaults to name
type String Well attribute type (VARCHAR, INTEGER, FLOAT, ENUM, DATE, IDENTIFIER, LIST); an IDENTIFIER attribute holds a string value that must be unique within the project
unit String Well attribute domain (POSITION, DISTANCE, DEPTH, ANGLE, VOLUME)
range Varies Allowed values of an ENUM attribute, optional: when present, a non-empty array of non-blank strings, unique case-insensitively, values are trimmed. Kept as is for other types
group_uuid String Well attribute group UUID
options Array Initial list option names for a LIST attribute; request order becomes the display order. Rejected for other types

Response body

Path Type Description
id Number Created well attribute Id
uuid String Created well attribute UUID
name String Created well attribute name (trimmed, inner whitespace collapsed)

Create well attribute list option

Create a new option of a LIST-type well attribute by well attribute UUID. sort_order is an ordering weight, not a strict position: duplicates are allowed, options with equal weight are ordered by name (case-insensitive). A locked attribute is rejected with 403, an attribute that is not LIST-type with 400

Request

$ curl 'https://solo.cloud/public/api/v1/wellattributes/d49ad8d2-31ed-449c-9b96-f4dc9d53b1fc/listoptions' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Crew C",
  "sort_order" : 2
}'

POST /public/api/v1/wellattributes/d49ad8d2-31ed-449c-9b96-f4dc9d53b1fc/listoptions HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 43

{
  "name" : "Crew C",
  "sort_order" : 2
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: efc8bb7e1f7bf843217a82e55290a78c
Content-Type: application/json

{
  "id" : 4,
  "uuid" : "c850b0ec-4119-4515-9a9b-55238195d1e4",
  "sort_order" : 2
}

POST /public/api/v1/wellattributes/{wellAttributeUuid}/listoptions

Path parameter Description
wellAttributeUuid LIST-type well attribute UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String List option name, up to 200 characters, unique within the attribute (case-insensitive), a duplicate is rejected with 409
sort_order Number Ordering weight (non-negative integer), not a strict position: duplicates are allowed, options with equal weight are ordered by name (case-insensitive). Appended after the last option when omitted

Response body

Path Type Description
id Number List option Id
uuid String List option UUID
sort_order Number Ordering weight of the created option

Get well attribute groups

Get a list of well attribute groups

Request

$ curl 'https://solo.cloud/public/api/v1/attributegroups' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/attributegroups HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 42dc56d49f758e5515bf453a22d3996d
Content-Type: application/json

[ {
  "name" : "General",
  "uuid" : "caeb5bb2-18ea-4191-9c36-f2e252259371"
}, {
  "name" : "Location",
  "uuid" : "b7ef6059-d428-4f35-9d4a-a786ffff1d83"
}, {
  "name" : "Well Status",
  "uuid" : "47f0b746-16e4-4959-a722-91a03c9d3aaf"
}, {
  "name" : "Dates",
  "uuid" : "a7bf5d85-6294-403e-8909-1ab9fda006f4"
}, {
  "name" : "Production",
  "uuid" : "a5b4f651-1212-4bf2-9ec5-f279480ffdad"
}, {
  "name" : "Completion",
  "uuid" : "d2bde9e4-2042-48b4-a3a2-eb49146c8145"
}, {
  "name" : "Development characteristics",
  "uuid" : "b995079d-7f89-4054-9276-93c69b70a6f5"
} ]

GET /public/api/v1/attributegroups

Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
[].name String Well attribute group name
[].uuid String Well attribute group UUID

Get predefined well attributes by group

Get a list of predefined well attributes by group UUID. When the optional project_uuid query parameter is passed, options of predefined LIST-type attributes (list_options) are resolved from that project's dictionaries and included in display order

Request

$ curl 'https://solo.cloud/public/api/v1/attributegroups/caeb5bb2-18ea-4191-9c36-f2e252259371/wellattributes?project_uuid=708be72a-8f5b-4cf5-9e0c-005b6565e45e' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/attributegroups/caeb5bb2-18ea-4191-9c36-f2e252259371/wellattributes?project_uuid=708be72a-8f5b-4cf5-9e0c-005b6565e45e HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e4d9338149978d570e1145462621687e
Content-Type: application/json

[ {
  "id" : 65,
  "uuid" : "00000000-0000-0000-0000-000000000065",
  "name" : "Rig Type",
  "name_short" : "Rig Type",
  "type" : "ENUM",
  "range" : [ "LAND", "OFFSHORE" ]
}, {
  "id" : 66,
  "uuid" : "00000000-0000-0000-0000-000000000066",
  "name" : "Air gap",
  "name_short" : "Air gap",
  "type" : "FLOAT"
}, {
  "id" : 67,
  "uuid" : "00000000-0000-0000-0000-000000000067",
  "name" : "Ground level",
  "name_short" : "Ground level",
  "type" : "FLOAT"
}, {
  "id" : 68,
  "uuid" : "00000000-0000-0000-0000-000000000068",
  "name" : "Water depth",
  "name_short" : "Water depth",
  "type" : "FLOAT"
}, {
  "id" : 69,
  "uuid" : "00000000-0000-0000-0000-000000000069",
  "name" : "Magnetic sample date",
  "name_short" : "Magnetic sample date",
  "type" : "DATE"
}, {
  "id" : 70,
  "uuid" : "00000000-0000-0000-0000-000000000070",
  "name" : "Magnetic model name",
  "name_short" : "Magnetic model name",
  "type" : "VARCHAR"
}, {
  "id" : 71,
  "uuid" : "00000000-0000-0000-0000-000000000071",
  "name" : "Magnetic field strength",
  "name_short" : "Magnetic field strength",
  "type" : "FLOAT"
}, {
  "id" : 72,
  "uuid" : "00000000-0000-0000-0000-000000000072",
  "name" : "Magnetic dip angle",
  "name_short" : "Magnetic dip angle",
  "type" : "FLOAT"
}, {
  "id" : 73,
  "uuid" : "00000000-0000-0000-0000-000000000073",
  "name" : "Magnetic declination",
  "name_short" : "Magnetic declination",
  "type" : "FLOAT"
}, {
  "id" : 74,
  "uuid" : "00000000-0000-0000-0000-000000000074",
  "name" : "Survey program",
  "name_short" : "Survey program",
  "type" : "VARCHAR"
}, {
  "id" : 7,
  "uuid" : "00000000-0000-0000-0000-000000000007",
  "name" : "KB",
  "name_short" : "KB",
  "type" : "FLOAT",
  "unit" : "DEPTH"
}, {
  "id" : 1,
  "uuid" : "00000000-0000-0000-0000-000000000001",
  "name" : "Name",
  "name_short" : "Name",
  "type" : "VARCHAR"
}, {
  "id" : 2,
  "uuid" : "00000000-0000-0000-0000-000000000002",
  "name" : "API",
  "name_short" : "API",
  "type" : "VARCHAR"
}, {
  "id" : 3,
  "uuid" : "00000000-0000-0000-0000-000000000003",
  "name" : "Well Type",
  "name_short" : "Type",
  "type" : "ENUM",
  "range" : [ "Horizontal", "Deviated", "Vertical", "Directional" ]
}, {
  "id" : 4,
  "uuid" : "00000000-0000-0000-0000-000000000004",
  "name" : "Operator",
  "name_short" : "OP",
  "type" : "VARCHAR"
}, {
  "id" : 5,
  "uuid" : "00000000-0000-0000-0000-000000000005",
  "name" : "Field",
  "name_short" : "Field",
  "type" : "VARCHAR"
}, {
  "id" : 6,
  "uuid" : "00000000-0000-0000-0000-000000000006",
  "name" : "Basin",
  "name_short" : "Basin",
  "type" : "VARCHAR"
}, {
  "id" : 8,
  "uuid" : "00000000-0000-0000-0000-000000000008",
  "name" : "Azimuth VS",
  "name_short" : "Az",
  "type" : "FLOAT",
  "unit" : "ANGLE",
  "range" : {
    "client" : {
      "max" : 360,
      "min" : 0
    }
  }
}, {
  "id" : 9,
  "uuid" : "00000000-0000-0000-0000-000000000009",
  "name" : "Convergence",
  "name_short" : "Conv",
  "type" : "FLOAT",
  "unit" : "ANGLE",
  "range" : {
    "client" : {
      "max" : 180,
      "min" : -180
    },
    "server" : {
      "max" : 360,
      "min" : 0
    }
  }
}, {
  "id" : 77,
  "uuid" : "00000000-0000-0000-0000-000000000077",
  "name" : "Rig",
  "name_short" : "Rig",
  "type" : "VARCHAR"
}, {
  "id" : 58,
  "uuid" : "00000000-0000-0000-0000-000000000058",
  "name" : "Well System",
  "name_short" : "System",
  "type" : "VARCHAR"
}, {
  "id" : 59,
  "uuid" : "00000000-0000-0000-0000-000000000059",
  "name" : "Pad",
  "name_short" : "Pad",
  "type" : "VARCHAR"
}, {
  "id" : 60,
  "uuid" : "00000000-0000-0000-0000-000000000060",
  "name" : "Source",
  "name_short" : "Source",
  "type" : "ENUM",
  "range" : [ "PN", "TGS" ]
} ]

GET /public/api/v1/attributegroups/{uuid}/wellattributes

Path parameter Description
uuid Well attribute group UUID
Parameter Description
project_uuid Project UUID; when passed, options of predefined LIST-type attributes (list_options) are resolved from this project's dictionaries and included
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
[].name String Well attribute name
[].name_short String Well attribute short name
[].id Number Well attribute Id
[].uuid String Well attribute UUID
[].type String Well attribute type (VARCHAR, INTEGER, FLOAT, ENUM, DATE, IDENTIFIER, LIST); an IDENTIFIER attribute carries a string value unique within the project
[].unit String Well attribute domain (POSITION, DISTANCE, DEPTH, ANGLE, VOLUME)
[].range Varies Well attribute range: the array of allowed values for ENUM, value limits (client) for some predefined numeric attributes
[].range.client Object Value limits to check before updating the value; angle limits are in degrees
[].range.client.min Number Minimum value
[].range.client.max Number Maximum value
[].list_options Array Options of a LIST attribute in display order, present only for LIST attributes and only when the project_uuid query parameter is passed
[].list_options[].id Number List option Id
[].list_options[].name String List option name
[].list_options[].sort_order Number List option ordering weight (display order: by weight, then by name)

Get custom well attributes by group and project

Get a list of custom well attributes by group UUID and project UUID. A LIST-type attribute is returned together with its options (list_options) in display order

Request

$ curl 'https://solo.cloud/public/api/v1/attributegroups/caeb5bb2-18ea-4191-9c36-f2e252259371/projects/708be72a-8f5b-4cf5-9e0c-005b6565e45e/wellattributes' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/attributegroups/caeb5bb2-18ea-4191-9c36-f2e252259371/projects/708be72a-8f5b-4cf5-9e0c-005b6565e45e/wellattributes HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 33a903cac58bb6d2049198cb11d86d74
Content-Type: application/json

[ {
  "id" : 10000,
  "uuid" : "87b26496-ec77-4352-b1bc-ea7bd187a196",
  "name" : "Well attribute name",
  "type" : "ENUM",
  "unit" : "POSITION",
  "range" : [ "Top", "Middle", "Bottom" ]
}, {
  "id" : 10001,
  "uuid" : "d49ad8d2-31ed-449c-9b96-f4dc9d53b1fc",
  "name" : "Frac Crew",
  "type" : "LIST",
  "list_options" : [ {
    "id" : 1,
    "name" : "Crew A",
    "sort_order" : 0
  }, {
    "id" : 2,
    "name" : "Crew B",
    "sort_order" : 1
  }, {
    "id" : 4,
    "name" : "Crew C",
    "sort_order" : 2
  }, {
    "id" : 5,
    "name" : "Crew D updated",
    "sort_order" : 10
  } ]
}, {
  "id" : 10002,
  "uuid" : "7ccaa9c1-4000-45da-bd91-f59b6a789548",
  "name" : "UWI",
  "type" : "IDENTIFIER"
}, {
  "id" : 10005,
  "uuid" : "6b5a4c4d-bab8-4eec-a4cd-b51b4331492d",
  "name" : "Custom attribute name",
  "name_short" : "Custom attribute name",
  "type" : "VARCHAR",
  "unit" : "DISTANCE"
} ]

GET /public/api/v1/attributegroups/{uuid}/projects/{projectUuid}/wellattributes

Path parameter Description
uuid Well attribute group UUID
projectUuid Project UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
[].name String Well attribute name
[].name_short String Well attribute short name
[].id Number Well attribute Id
[].uuid String Well attribute uuid
[].type String Well attribute type (VARCHAR, INTEGER, FLOAT, ENUM, DATE, IDENTIFIER, LIST); an IDENTIFIER attribute carries a string value unique within the project
[].unit String Well attribute domain (POSITION, DISTANCE, DEPTH, ANGLE, VOLUME)
[].range Varies Well attribute range: the array of allowed values for ENUM, value limits (client) for some predefined numeric attributes
[].range.client Object Value limits to check before updating the value; angle limits are in degrees
[].range.client.min Number Minimum value
[].range.client.max Number Maximum value
[].list_options Array Options of a LIST attribute in display order; absent for other types
[].list_options[].id Number List option Id
[].list_options[].name String List option name
[].list_options[].sort_order Number List option ordering weight (display order: by weight, then by name)

Get well attribute values by lateral

Get well attribute values by lateral UUID as an object keyed by well attribute name. The KB, lateral length, final MD, final TVD and final TVDSS values are returned in project units, the azimuth VS and convergence values in degrees, X-srf and Y-srf in project units, other numeric values are returned as stored. A value of a LIST-type attribute is returned as the resolved list option object; null if the option no longer exists

Request

$ curl 'https://solo.cloud/public/api/v1/wells/c2db2035-9b3b-4646-acd5-c872eb2d8d2d/attributevalues/v2' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/c2db2035-9b3b-4646-acd5-c872eb2d8d2d/attributevalues/v2 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 29904637683571ca35d1fe7c07f0d476
Content-Type: application/json

{
  "Name" : {
    "value" : "nameWell",
    "attribute_id" : 1
  },
  "API" : {
    "value" : "api",
    "attribute_id" : 2
  },
  "Well Type" : {
    "value" : "Deviated",
    "attribute_id" : 3
  },
  "Operator" : {
    "value" : "operator",
    "attribute_id" : 4
  },
  "KB" : {
    "value" : {
      "val" : 3445.211614173228
    },
    "attribute_id" : 7
  },
  "Azimuth VS" : {
    "value" : {
      "val" : 114.59155902616465
    },
    "attribute_id" : 8
  },
  "Convergence" : {
    "value" : {
      "val" : 171.88733853924697
    },
    "attribute_id" : 9
  },
  "State (Province)" : {
    "value" : "Penguin State ",
    "attribute_id" : 10
  },
  "X-srf" : {
    "value" : {
      "val" : 13.123359580052492
    },
    "attribute_id" : 12
  },
  "Y-srf" : {
    "value" : {
      "val" : 16.404199475065617
    },
    "attribute_id" : 13
  },
  "Spud date" : {
    "value" : "2023-12-18T14:16:32.001+00:00",
    "attribute_id" : 17
  },
  "# of Stages" : {
    "value" : 20,
    "attribute_id" : 43
  },
  "Frac Fluid" : {
    "value" : "X-link",
    "attribute_id" : 46
  },
  "Final TVD" : {
    "value" : {
      "val" : 1.6076115485564304
    },
    "attribute_id" : 49
  },
  "Final TVDSS" : {
    "value" : {
      "val" : -1.6404199475065615
    },
    "attribute_id" : 50
  },
  "Formation" : {
    "value" : "test51",
    "attribute_id" : 51
  },
  "Net pay" : {
    "value" : {
      "val" : 52.0
    },
    "attribute_id" : 52
  },
  "Frac Crew" : {
    "value" : {
      "id" : 1,
      "name" : "Crew A",
      "sort_order" : 0
    },
    "attribute_id" : 10001
  },
  "UWI" : {
    "value" : "UWI-0001",
    "attribute_id" : 10002
  }
}

GET /public/api/v1/wells/{uuid}/attributevalues/v2

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
.value Object Well attribute value: a string for VARCHAR, ENUM, IDENTIFIER (unique within the project) and DATE (ISO 8601 date-time), a number for INTEGER, a double value object for FLOAT, a list option object for LIST; null when the value is cleared or the list option no longer exists
.value.val Number Value of a FLOAT attribute; KB, lateral length and final MD/TVD/TVDSS are in project units, azimuth VS and convergence in degrees
.value.undefined Boolean true when a FLOAT value is not set
.value.id Number Resolved list option Id (for LIST type)
.value.name String Resolved list option name (for LIST type)
.value.sort_order Number Resolved list option ordering weight (for LIST type)
*.attribute_id Number Well attribute Id

Get well attribute values by nestedwell

Get well attribute values by nested well UUID as an object keyed by well attribute name. The KB, lateral length, final MD, final TVD and final TVDSS values are returned in project units, the azimuth VS and convergence values in degrees, X-srf and Y-srf in project units, other numeric values are returned as stored. A value of a LIST-type attribute is returned as the resolved list option object; null if the option no longer exists

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/eee7d4b0-ca6a-4673-ba65-a119f01cc23c/attributevalues/v2' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/nestedwells/eee7d4b0-ca6a-4673-ba65-a119f01cc23c/attributevalues/v2 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: af90570940f0aa371e9706604d535fcb
Content-Type: application/json

{
  "Name" : {
    "value" : "nestedName",
    "attribute_id" : 1
  },
  "API" : {
    "value" : "nestedApi",
    "attribute_id" : 2
  },
  "Operator" : {
    "value" : "nestedOperator",
    "attribute_id" : 4
  },
  "KB" : {
    "value" : {
      "val" : 328.4120734908136
    },
    "attribute_id" : 7
  },
  "Azimuth VS" : {
    "value" : {
      "val" : 5.729577951308232
    },
    "attribute_id" : 8
  },
  "Convergence" : {
    "value" : {
      "val" : 11.459155902616464
    },
    "attribute_id" : 9
  },
  "X-srf" : {
    "value" : {
      "val" : 103.1
    },
    "attribute_id" : 12
  },
  "Y-srf" : {
    "value" : {
      "val" : 104.1
    },
    "attribute_id" : 13
  }
}

GET /public/api/v1/nestedwells/{uuid}/attributevalues/v2

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
.value Object Well attribute value: a string for VARCHAR, ENUM, IDENTIFIER (unique within the project) and DATE (ISO 8601 date-time), a number for INTEGER, a double value object for FLOAT, a list option object for LIST; null when the value is cleared or the list option no longer exists
.value.val Number Value of a FLOAT attribute; KB, lateral length and final MD/TVD/TVDSS are in project units, azimuth VS and convergence in degrees
.value.undefined Boolean true when a FLOAT value is not set
.value.id Number Resolved list option Id (for LIST type)
.value.name String Resolved list option name (for LIST type)
.value.sort_order Number Resolved list option ordering weight (for LIST type)
*.attribute_id Number Well attribute Id

Get well attribute values by typewell

Get well attribute values by typewell UUID as an object keyed by well attribute name. The KB, lateral length, final MD, final TVD and final TVDSS values are returned in project units, the azimuth VS and convergence values in degrees, X-srf and Y-srf in project units, other numeric values are returned as stored. A value of a LIST-type attribute is returned as the resolved list option object; null if the option no longer exists

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/17d2ea79-e05d-490f-9ceb-d1c4f880fa77/attributevalues/v2' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/17d2ea79-e05d-490f-9ceb-d1c4f880fa77/attributevalues/v2 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: adba7dad6c74f1845e8ad1cd68559b30
Content-Type: application/json

{
  "Name" : {
    "value" : "nameWell",
    "attribute_id" : 1
  },
  "API" : {
    "value" : "api",
    "attribute_id" : 2
  },
  "Well Type" : {
    "value" : "Deviated",
    "attribute_id" : 3
  },
  "Operator" : {
    "value" : "operator",
    "attribute_id" : 4
  },
  "KB" : {
    "value" : {
      "val" : 3.280839895013123
    },
    "attribute_id" : 7
  },
  "Azimuth VS" : {
    "value" : {
      "val" : 114.59155902616465
    },
    "attribute_id" : 8
  },
  "Convergence" : {
    "value" : {
      "val" : 171.88733853924697
    },
    "attribute_id" : 9
  },
  "X-srf" : {
    "value" : {
      "val" : 13.123359580052492
    },
    "attribute_id" : 12
  },
  "Y-srf" : {
    "value" : {
      "val" : 16.404199475065617
    },
    "attribute_id" : 13
  },
  "Spud date" : {
    "value" : "2022-11-17T13:15:31.000+00:00",
    "attribute_id" : 17
  },
  "# of Stages" : {
    "value" : 43,
    "attribute_id" : 43
  },
  "Final TVD" : {
    "value" : {
      "val" : 1.6076115485564304
    },
    "attribute_id" : 49
  },
  "Final TVDSS" : {
    "value" : {
      "val" : -1.6404199475065615
    },
    "attribute_id" : 50
  },
  "Formation" : {
    "value" : "test51",
    "attribute_id" : 51
  },
  "Net pay" : {
    "value" : {
      "val" : 52.0
    },
    "attribute_id" : 52
  }
}

GET /public/api/v1/typewells/{uuid}/attributevalues/v2

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
.value Object Well attribute value: a string for VARCHAR, ENUM, IDENTIFIER (unique within the project) and DATE (ISO 8601 date-time), a number for INTEGER, a double value object for FLOAT, a list option object for LIST; null when the value is cleared or the list option no longer exists
.value.val Number Value of a FLOAT attribute; KB, lateral length and final MD/TVD/TVDSS are in project units, azimuth VS and convergence in degrees
.value.undefined Boolean true when a FLOAT value is not set
.value.id Number Resolved list option Id (for LIST type)
.value.name String Resolved list option name (for LIST type)
.value.sort_order Number Resolved list option ordering weight (for LIST type)
*.attribute_id Number Well attribute Id

Update custom well attribute

Update custom well attribute by UUID. At least one field must be present, an absent field keeps its current value. A locked attribute is rejected with 403

Request

$ curl 'https://solo.cloud/public/api/v1/wellattributes/1e115023-3e7b-4325-b4e6-7ca391103f6a' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Updated well attribute name",
  "name_short" : "New short name",
  "group_uuid" : "b7ef6059-d428-4f35-9d4a-a786ffff1d83"
}'

PATCH /public/api/v1/wellattributes/1e115023-3e7b-4325-b4e6-7ca391103f6a HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 136

{
  "name" : "Updated well attribute name",
  "name_short" : "New short name",
  "group_uuid" : "b7ef6059-d428-4f35-9d4a-a786ffff1d83"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 542e26f7ddf046252e04afce802c3745

PATCH /public/api/v1/wellattributes/{wellAttributeUuid}

Path parameter Description
wellAttributeUuid Well attribute UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String New well attribute name, unique (case-insensitive) among the project's custom and the predefined attributes
name_short String New well attribute short name
group_uuid String Well attribute group UUID to place the attribute in

Response body

Empty body

Update well attribute list option

Update a list option of a LIST-type well attribute by well attribute UUID and option Id. Both fields are optional, but at least one must be present; an absent field keeps its current value. sort_order is an ordering weight, not a strict position: duplicates are allowed, options with equal weight are ordered by name (case-insensitive). A locked attribute is rejected with 403, an attribute that is not LIST-type with 400. An option Id that does not exist returns 400 with type NOT_FOUND

Request

$ curl 'https://solo.cloud/public/api/v1/wellattributes/d49ad8d2-31ed-449c-9b96-f4dc9d53b1fc/listoptions/5' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Crew D updated",
  "sort_order" : 10
}'

PATCH /public/api/v1/wellattributes/d49ad8d2-31ed-449c-9b96-f4dc9d53b1fc/listoptions/5 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 52

{
  "name" : "Crew D updated",
  "sort_order" : 10
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e49b529728fff7db14a98a5e9d82665b

PATCH /public/api/v1/wellattributes/{wellAttributeUuid}/listoptions/{optionId}

Path parameter Description
wellAttributeUuid LIST-type well attribute UUID
optionId List option Id
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String New list option name, up to 200 characters, unique within the attribute (case-insensitive), a duplicate is rejected with 409
sort_order Number New ordering weight (non-negative integer): duplicates are allowed, options with equal weight are ordered by name (case-insensitive)

Response body

Empty body

Update well attribute values by lateral

Update well attribute values by lateral UUID. Only the listed attributes are changed, the values of locked attributes are ignored. The values to be changed must be pre-checked for validity using the range constraints returned by Get predefined well attributes by group and Get custom well attributes by group and project (if applicable). This path takes the KB, lateral length, final MD, final TVD and final TVDSS values in meters and the azimuth VS and convergence values in radians, without conversion, /wells/{uuid}/attributevalues/v2 takes them in project units and degrees, as returned by Get well attribute values by lateral. Other values are stored as submitted. For this path compare the azimuth VS and convergence values with the range limits converted to radians. For a LIST-type attribute pass the Id of one of the attribute's list options as the value; null clears the value. An unknown attribute_id, a LIST value that is not an Id of the attribute's options, a negative KB, lateral length, final MD or final TVD, and an azimuth VS outside [0; 360] degrees or a convergence outside [-180; 180] degrees (radians on this path) are rejected with 406. A value whose JSON type does not match the attribute type is rejected with 400. For an IDENTIFIER-type attribute the value must be unique within the project (case-insensitive, leading/trailing spaces ignored; laterals and typewells share one uniqueness scope): a duplicate is rejected with 409 (NOT_ACCEPTED), null clears the value and releases it

Request

$ curl 'https://solo.cloud/public/api/v1/wells/c2db2035-9b3b-4646-acd5-c872eb2d8d2d/attributevalues' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '[ {
  "value" : "Penguin State ",
  "attribute_id" : 10
}, {
  "value" : {
    "val" : 1050.1005
  },
  "attribute_id" : 7
}, {
  "value" : 20,
  "attribute_id" : 43
}, {
  "value" : "2023-12-18T14:16:32.001+00:00",
  "attribute_id" : 17
}, {
  "value" : "X-link",
  "attribute_id" : 46
} ]'

PATCH /public/api/v1/wells/c2db2035-9b3b-4646-acd5-c872eb2d8d2d/attributevalues HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 290

[ {
  "value" : "Penguin State ",
  "attribute_id" : 10
}, {
  "value" : {
    "val" : 1050.1005
  },
  "attribute_id" : 7
}, {
  "value" : 20,
  "attribute_id" : 43
}, {
  "value" : "2023-12-18T14:16:32.001+00:00",
  "attribute_id" : 17
}, {
  "value" : "X-link",
  "attribute_id" : 46
} ]

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 6ccfc39e626c83d8be15224f45e507e6

PATCH /public/api/v1/wells/{uuid}/attributevalues

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
[].attribute_id Number Well attribute Id; attributes that are not listed keep their values
[].value Varies New value: a string for VARCHAR, ENUM and IDENTIFIER, an ISO 8601 date-time string for DATE, an integer for INTEGER, a double value object for FLOAT, a list option Id for LIST; null clears the value
[].value.val Number Value of a FLOAT attribute; on this path KB, lateral length and final MD/TVD/TVDSS are in meters, azimuth VS and convergence in radians
[].value.undefined Boolean Set to true to store an undefined FLOAT value

Response body

Empty body

Update well attribute values by typewell

Update well attribute values by typewell UUID. Only the listed attributes are changed, the values of locked attributes are ignored. The values to be changed must be pre-checked for validity using the range constraints returned by Get predefined well attributes by group and Get custom well attributes by group and project (if applicable). This path takes the KB, lateral length, final MD, final TVD and final TVDSS values in meters and the azimuth VS and convergence values in radians, without conversion, /typewells/{uuid}/attributevalues/v2 takes them in project units and degrees, as returned by Get well attribute values by typewell. Other values are stored as submitted. For this path compare the azimuth VS and convergence values with the range limits converted to radians. For a LIST-type attribute pass the Id of one of the attribute's list options as the value; null clears the value. An unknown attribute_id, a LIST value that is not an Id of the attribute's options, a negative KB, lateral length, final MD or final TVD, and an azimuth VS outside [0; 360] degrees or a convergence outside [-180; 180] degrees (radians on this path) are rejected with 406. A value whose JSON type does not match the attribute type is rejected with 400. For an IDENTIFIER-type attribute the value must be unique within the project (case-insensitive, leading/trailing spaces ignored; laterals and typewells share one uniqueness scope): a duplicate is rejected with 409 (NOT_ACCEPTED), null clears the value and releases it

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/17d2ea79-e05d-490f-9ceb-d1c4f880fa77/attributevalues' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '[ {
  "value" : "Penguin State ",
  "attribute_id" : 10
}, {
  "value" : {
    "val" : 1050.1005
  },
  "attribute_id" : 7
}, {
  "value" : 20,
  "attribute_id" : 43
}, {
  "value" : "2023-12-18T14:16:32.001+00:00",
  "attribute_id" : 17
}, {
  "value" : "X-link",
  "attribute_id" : 46
} ]'

PATCH /public/api/v1/typewells/17d2ea79-e05d-490f-9ceb-d1c4f880fa77/attributevalues HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 290

[ {
  "value" : "Penguin State ",
  "attribute_id" : 10
}, {
  "value" : {
    "val" : 1050.1005
  },
  "attribute_id" : 7
}, {
  "value" : 20,
  "attribute_id" : 43
}, {
  "value" : "2023-12-18T14:16:32.001+00:00",
  "attribute_id" : 17
}, {
  "value" : "X-link",
  "attribute_id" : 46
} ]

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 0e1ddd8f89854919de7a2d26925deb19

PATCH /public/api/v1/typewells/{uuid}/attributevalues

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
[].attribute_id Number Well attribute Id; attributes that are not listed keep their values
[].value Varies New value: a string for VARCHAR, ENUM and IDENTIFIER, an ISO 8601 date-time string for DATE, an integer for INTEGER, a double value object for FLOAT, a list option Id for LIST; null clears the value
[].value.val Number Value of a FLOAT attribute; on this path KB, lateral length and final MD/TVD/TVDSS are in meters, azimuth VS and convergence in radians
[].value.undefined Boolean Set to true to store an undefined FLOAT value

Response body

Empty body

Delete custom well attribute

Delete custom well attribute by UUID. Its values are no longer returned for wells. A locked attribute is rejected with 403

Request

$ curl 'https://solo.cloud/public/api/v1/wellattributes/8af9ba1c-78d9-4162-aa2b-d5c774e27606' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/wellattributes/8af9ba1c-78d9-4162-aa2b-d5c774e27606 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 8c0cd4eccd98a61af13e3fb77ffd9f3d

DELETE /public/api/v1/wellattributes/{wellAttributeUuid}

Path parameter Description
wellAttributeUuid Well attribute UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Delete well attribute list option

Delete a list option of a LIST-type well attribute by well attribute UUID and option Id. Well attribute values that reference the deleted option are returned as null. A locked attribute is rejected with 403, an attribute that is not LIST-type with 400. An option Id that does not exist returns 400 with type NOT_FOUND

Request

$ curl 'https://solo.cloud/public/api/v1/wellattributes/d49ad8d2-31ed-449c-9b96-f4dc9d53b1fc/listoptions/3' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/wellattributes/d49ad8d2-31ed-449c-9b96-f4dc9d53b1fc/listoptions/3 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f67168219b47560bf7e41012065e429a

DELETE /public/api/v1/wellattributes/{wellAttributeUuid}/listoptions/{optionId}

Path parameter Description
wellAttributeUuid LIST-type well attribute UUID
optionId List option Id
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

16. Grids

Create grid

Create an empty grid by project UUID (a virtual project UUID is also accepted). The grid is not listed by Get grids by project until its data is uploaded. A grid created with a virtual project UUID belongs to the global project and is added to the virtual project only if its first data upload is made with Upload grid data to VP

Request

$ curl 'https://solo.cloud/public/api/v1/projects/daec53c6-ee9f-46ab-b225-88845504224b/grids' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Grid name"
}'

POST /public/api/v1/projects/daec53c6-ee9f-46ab-b225-88845504224b/grids HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 26

{
  "name" : "Grid name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: da77f39640c801f6dca5b330256142d2
Content-Type: application/json

{
  "uuid" : "3e627bff-60f2-4eb0-a2b3-09c7f29877e2"
}

POST /public/api/v1/projects/{uuid}/grids

Path parameter Description
uuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Grid name. Must not be blank, up to 200 characters

Response body

Path Type Description
uuid String Created grid UUID

Get grids by project

Get a list of grids by project UUID with pagination, sorted by name. For a virtual project UUID, only grids of the virtual project are returned. Grids that do not contain data will not be included in the response

Request

$ curl 'https://solo.cloud/public/api/v1/projects/daec53c6-ee9f-46ab-b225-88845504224b/grids?offset=0&limit=10&filter=oNe' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/daec53c6-ee9f-46ab-b225-88845504224b/grids?offset=0&limit=10&filter=oNe HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: c2f5fff3d544945894e2e253dffb7d68
Content-Type: application/json

{
  "content" : [ {
    "name" : "Grid one",
    "uuid" : "8b573d24-2054-48a9-8663-ec6ab132fdb4"
  }, {
    "name" : "One more grid",
    "uuid" : "d5817f4d-6056-4725-9ea6-338257ec04ba"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{uuid}/grids

Path parameter Description
uuid Project UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the grids whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Grid UUID
content[].name String Grid name

Get grid metadata

Get grid metadata by UUID. Coordinates and steps are in project units, the angle is in degrees. Returns 404 if the grid has no data

Request

$ curl 'https://solo.cloud/public/api/v1/grids/4838db65-b053-4d4b-97fc-21fb6819cfbf/metadata' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/grids/4838db65-b053-4d4b-97fc-21fb6819cfbf/metadata HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 27c73b417d5544272e1b271f1307cb43
Content-Type: application/json

{
  "start_x" : 1761026.4432000222,
  "start_y" : 508018.38319997117,
  "step_x" : 50.00000000089999,
  "step_y" : 50.000899999999994,
  "angle" : 3.4377511537473244E-4,
  "columns" : 10,
  "rows" : 5
}

GET /public/api/v1/grids/{uuid}/metadata

Path parameter Description
uuid Grid UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
start_x Number X coordinate of the grid origin in project units
start_y Number Y coordinate of the grid origin in project units
step_x Number Grid X-axis step in project units
step_y Number Grid Y-axis step in project units
angle Number Grid rotation angle (degrees)
columns Number Number of grid columns (values in each row)
rows Number Number of grid rows

Get grid data

Get grid metadata and values by UUID. data contains rows rows numbered from 1, each with columns values. Grid values are returned as stored, without unit conversion. Returns 404 if the grid has no data

Request

$ curl 'https://solo.cloud/public/api/v1/grids/4838db65-b053-4d4b-97fc-21fb6819cfbf/data' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/grids/4838db65-b053-4d4b-97fc-21fb6819cfbf/data HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 933b10f1524db6cb12fc53fb479cef34
Content-Type: application/json

{
  "metadata" : {
    "start_x" : 1761026.4432000222,
    "start_y" : 508018.38319997117,
    "step_x" : 50.00000000089999,
    "step_y" : 50.000899999999994,
    "angle" : 3.4377511537473244E-4,
    "columns" : 10,
    "rows" : 5
  },
  "data" : [ {
    "row_number" : 1,
    "values" : [ -4004.1541, -4005.4883, -4006.1639, -4004.9126, -4003.3309, -4001.4009, -3998.938, -3996.5938, -3994.3135, -3991.4742 ]
  }, {
    "row_number" : 2,
    "values" : [ -4006.5755, -4007.4856, -4008.077, -4006.9102, -4005.2642, -4002.824, -4000.285, -3998.0855, -3996.1604, -3993.5733 ]
  }, {
    "row_number" : 3,
    "values" : [ -4009.1927, -4010.4065, -4011.1248, -4009.6104, -4007.5018, -4004.8636, -4002.7835, -4000.7776, -3998.6927, -3994.7417 ]
  }, {
    "row_number" : 4,
    "values" : [ -4012.2437, -4013.699, -4014.2129, -4012.1336, -4009.8895, -4007.2583, -4005.5298, -4003.5118, -3999.9412, -3995.8165 ]
  }, {
    "row_number" : 5,
    "values" : [ -4016.2227, -4016.9622, -4016.6907, -4014.7264, -4012.2242, -4009.7496, -4008.4166, -4005.1592, -4001.252, -3996.7496 ]
  } ]
}

GET /public/api/v1/grids/{uuid}/data

Path parameter Description
uuid Grid UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
metadata.start_x Number X coordinate of the grid origin in project units
metadata.start_y Number Y coordinate of the grid origin in project units
metadata.step_x Number Grid X-axis step in project units
metadata.step_y Number Grid Y-axis step in project units
metadata.angle Number Grid rotation angle (degrees)
metadata.columns Number Number of grid columns (values in each row)
metadata.rows Number Number of grid rows
data Array Grid rows in row_number order
data[].row_number Number Row number, starting from 1
data[].values Array Row values, one per column. Returned as stored, without unit conversion

Upload grid data to GP

Upload grid data by grid UUID, replacing the existing grid data. metadata must be the first field of the body and data the second one. The grid must have at least 5 rows, 5 columns and 50 nodes, data must contain exactly rows rows numbered 1, 2, ... in order, each with exactly columns values. A body that breaks these rules or cannot be read, including a row without values, is rejected with 406 (INVALID_REQUEST_BODY_FORMAT). If the data cannot be saved, the error status of the Solo data service is returned (type INVALID_REQUEST). Coordinates and steps are in project units, the angle is in degrees, grid values are stored without unit conversion. Requires the Update permission in the global project

Request

$ curl 'https://solo.cloud/public/api/v1/grids/4838db65-b053-4d4b-97fc-21fb6819cfbf/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "metadata" : {
    "start_x" : 111.5,
    "start_y" : 555.1,
    "step_x" : 10,
    "step_y" : 20,
    "angle" : 120,
    "columns" : 10,
    "rows" : 5
  },
  "data" : [ {
    "row_number" : 1,
    "values" : [ -4004.1541, -4005.4883, -4006.1639, -4004.9126, -4003.3309, -4001.4009, -3998.938, -3996.5938, -3994.3135, -3991.4742 ]
  }, {
    "row_number" : 2,
    "values" : [ -4006.5755, -4007.4856, -4008.077, -4006.9102, -4005.2642, -4002.824, -4000.285, -3998.0855, -3996.1604, -3993.5733 ]
  }, {
    "row_number" : 3,
    "values" : [ -4009.1927, -4010.4065, -4011.1248, -4009.6104, -4007.5018, -4004.8636, -4002.7835, -4000.7776, -3998.6927, -3994.7417 ]
  }, {
    "row_number" : 4,
    "values" : [ -4012.2437, -4013.699, -4014.2129, -4012.1336, -4009.8895, -4007.2583, -4005.5298, -4003.5118, -3999.9412, -3995.8165 ]
  }, {
    "row_number" : 5,
    "values" : [ -4016.2227, -4016.9622, -4016.6907, -4014.7264, -4012.2242, -4009.7496, -4008.4166, -4005.1592, -4001.252, -3996.7496 ]
  } ]
}'

PUT /public/api/v1/grids/4838db65-b053-4d4b-97fc-21fb6819cfbf/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 1006

{
  "metadata" : {
    "start_x" : 111.5,
    "start_y" : 555.1,
    "step_x" : 10,
    "step_y" : 20,
    "angle" : 120,
    "columns" : 10,
    "rows" : 5
  },
  "data" : [ {
    "row_number" : 1,
    "values" : [ -4004.1541, -4005.4883, -4006.1639, -4004.9126, -4003.3309, -4001.4009, -3998.938, -3996.5938, -3994.3135, -3991.4742 ]
  }, {
    "row_number" : 2,
    "values" : [ -4006.5755, -4007.4856, -4008.077, -4006.9102, -4005.2642, -4002.824, -4000.285, -3998.0855, -3996.1604, -3993.5733 ]
  }, {
    "row_number" : 3,
    "values" : [ -4009.1927, -4010.4065, -4011.1248, -4009.6104, -4007.5018, -4004.8636, -4002.7835, -4000.7776, -3998.6927, -3994.7417 ]
  }, {
    "row_number" : 4,
    "values" : [ -4012.2437, -4013.699, -4014.2129, -4012.1336, -4009.8895, -4007.2583, -4005.5298, -4003.5118, -3999.9412, -3995.8165 ]
  }, {
    "row_number" : 5,
    "values" : [ -4016.2227, -4016.9622, -4016.6907, -4014.7264, -4012.2242, -4009.7496, -4008.4166, -4005.1592, -4001.252, -3996.7496 ]
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3970718f55916108f067707be109acfa

PUT /public/api/v1/grids/{uuid}/data

Path parameter Description
uuid Grid UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
metadata.start_x Number X coordinate of the grid origin in project units
metadata.start_y Number Y coordinate of the grid origin in project units
metadata.step_x Number Grid X-axis step in project units
metadata.step_y Number Grid Y-axis step in project units
metadata.angle Number Grid rotation angle in degrees, range [-180; 180]
metadata.columns Number Number of grid columns (values in each row), at least 5
metadata.rows Number Number of grid rows, at least 5. rows * columns must be at least 50
data Array Grid rows, exactly rows elements. Must follow metadata in the body
data[].row_number Number Row number. Rows must go in order 1, 2, ..., rows
data[].values Array Row values, exactly columns numbers. Stored as is, without unit conversion

Response body

Empty body

Upload grid data to VP

Upload grid data by grid UUID and virtual project UUID, with the same body and rules as Upload grid data to GP. The grid must belong to the global project of the virtual project, otherwise 400 is returned. The Update permission is checked in the virtual project. Grid data is shared, so the upload replaces the data seen in the global project and in all its virtual projects. If the grid had no data before, it is also added to the given virtual project

Request

$ curl 'https://solo.cloud/public/api/v1/projects/667b2d78-818a-4076-942c-5e1919d488b1/grids/d5817f4d-6056-4725-9ea6-338257ec04ba/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "metadata" : {
    "start_x" : 111.5,
    "start_y" : 555.1,
    "step_x" : 10,
    "step_y" : 20,
    "angle" : 120,
    "columns" : 10,
    "rows" : 5
  },
  "data" : [ {
    "row_number" : 1,
    "values" : [ -4004.1541, -4005.4883, -4006.1639, -4004.9126, -4003.3309, -4001.4009, -3998.938, -3996.5938, -3994.3135, -3991.4742 ]
  }, {
    "row_number" : 2,
    "values" : [ -4006.5755, -4007.4856, -4008.077, -4006.9102, -4005.2642, -4002.824, -4000.285, -3998.0855, -3996.1604, -3993.5733 ]
  }, {
    "row_number" : 3,
    "values" : [ -4009.1927, -4010.4065, -4011.1248, -4009.6104, -4007.5018, -4004.8636, -4002.7835, -4000.7776, -3998.6927, -3994.7417 ]
  }, {
    "row_number" : 4,
    "values" : [ -4012.2437, -4013.699, -4014.2129, -4012.1336, -4009.8895, -4007.2583, -4005.5298, -4003.5118, -3999.9412, -3995.8165 ]
  }, {
    "row_number" : 5,
    "values" : [ -4016.2227, -4016.9622, -4016.6907, -4014.7264, -4012.2242, -4009.7496, -4008.4166, -4005.1592, -4001.252, -3996.7496 ]
  } ]
}'

PUT /public/api/v1/projects/667b2d78-818a-4076-942c-5e1919d488b1/grids/d5817f4d-6056-4725-9ea6-338257ec04ba/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 1006

{
  "metadata" : {
    "start_x" : 111.5,
    "start_y" : 555.1,
    "step_x" : 10,
    "step_y" : 20,
    "angle" : 120,
    "columns" : 10,
    "rows" : 5
  },
  "data" : [ {
    "row_number" : 1,
    "values" : [ -4004.1541, -4005.4883, -4006.1639, -4004.9126, -4003.3309, -4001.4009, -3998.938, -3996.5938, -3994.3135, -3991.4742 ]
  }, {
    "row_number" : 2,
    "values" : [ -4006.5755, -4007.4856, -4008.077, -4006.9102, -4005.2642, -4002.824, -4000.285, -3998.0855, -3996.1604, -3993.5733 ]
  }, {
    "row_number" : 3,
    "values" : [ -4009.1927, -4010.4065, -4011.1248, -4009.6104, -4007.5018, -4004.8636, -4002.7835, -4000.7776, -3998.6927, -3994.7417 ]
  }, {
    "row_number" : 4,
    "values" : [ -4012.2437, -4013.699, -4014.2129, -4012.1336, -4009.8895, -4007.2583, -4005.5298, -4003.5118, -3999.9412, -3995.8165 ]
  }, {
    "row_number" : 5,
    "values" : [ -4016.2227, -4016.9622, -4016.6907, -4014.7264, -4012.2242, -4009.7496, -4008.4166, -4005.1592, -4001.252, -3996.7496 ]
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 839660b5c451f1367142d8dcdd73da3b

PUT /public/api/v1/projects/{projectUuid}/grids/{gridUuid}/data

Path parameter Description
projectUuid Virtual project UUID
gridUuid UUID of a grid of the global project of the virtual project
Header Description
Authorization OAuth2 authorization header
Body field Type Description
metadata.start_x Number X coordinate of the grid origin in project units
metadata.start_y Number Y coordinate of the grid origin in project units
metadata.step_x Number Grid X-axis step in project units
metadata.step_y Number Grid Y-axis step in project units
metadata.angle Number Grid rotation angle in degrees, range [-180; 180]
metadata.columns Number Number of grid columns (values in each row), at least 5
metadata.rows Number Number of grid rows, at least 5. rows * columns must be at least 50
data Array Grid rows, exactly rows elements. Must follow metadata in the body
data[].row_number Number Row number. Rows must go in order 1, 2, ..., rows
data[].values Array Row values, exactly columns numbers. Stored as is, without unit conversion

Response body

Empty body

17. Polygons

Create polygon

Create an empty polygon by project UUID (a virtual project UUID is also accepted). The polygon is not listed by Get polygons by project until its data is uploaded. A polygon created with a virtual project UUID belongs to the global project and is added to the virtual project only if its first data upload is made with Upload polygon data to VP. Returns 409 if the polygon cannot be saved

Request

$ curl 'https://solo.cloud/public/api/v1/projects/3c3b08ad-33b9-4355-9355-a516452be89f/polygons' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Polygon name"
}'

POST /public/api/v1/projects/3c3b08ad-33b9-4355-9355-a516452be89f/polygons HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 29

{
  "name" : "Polygon name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: c4a1f0396e4c891e95a22611aa496183
Content-Type: application/json

{
  "uuid" : "10a58090-83b0-4d71-a142-771fc1dc6360"
}

POST /public/api/v1/projects/{uuid}/polygons

Path parameter Description
uuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Polygon name. Must not be blank, up to 200 characters

Response body

Path Type Description
uuid String Created polygon UUID

Get polygons by project

Get a list of polygons by project UUID with pagination, sorted by name. For a virtual project UUID, only polygons of the virtual project are returned. Polygons that do not contain data will not be included in the response

Request

$ curl 'https://solo.cloud/public/api/v1/projects/3c3b08ad-33b9-4355-9355-a516452be89f/polygons?offset=0&limit=10&filter=oNe' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/3c3b08ad-33b9-4355-9355-a516452be89f/polygons?offset=0&limit=10&filter=oNe HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 1fabf33d28a318ee8389adad328b2635
Content-Type: application/json

{
  "content" : [ {
    "name" : "One more polygon",
    "uuid" : "a2883494-14a7-4ed0-af8e-49431db75bcd"
  }, {
    "name" : "Polygon one",
    "uuid" : "4226dd3e-8124-4b4a-aeaf-31daf80072de"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{uuid}/polygons

Path parameter Description
uuid Project UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the polygons whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Polygon UUID
content[].name String Polygon name

Get polygon data

Get the polylines of a polygon by UUID. Coordinates are in project units. Returns 404 if the polygon has no data

Request

$ curl 'https://solo.cloud/public/api/v1/polygons/19af44c4-58b5-45b2-818e-8814ef5382d6/data' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/polygons/19af44c4-58b5-45b2-818e-8814ef5382d6/data HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 8be884f74b4bb7c90ae260cf579761d8
Content-Type: application/json

[ {
  "label" : "",
  "points_count" : 24,
  "xyz_points" : [ {
    "x" : 1791071.9272422243,
    "y" : 2.505124146981627E7,
    "z" : 1.6404199507874015E8
  }, {
    "x" : 1789698.1627296587,
    "y" : 2.505965649606299E7,
    "z" : -1.6404199507874015E8
  }, {
    "x" : 1795150.2624671916,
    "y" : 2.504813877952756E7,
    "z" : -5389.763779527559
  }, {
    "x" : 1796545.93175853,
    "y" : 2.5044033464566927E7,
    "z" : -5406.496062992126
  }, {
    "x" : 1790436.0236220472,
    "y" : 2.50544937664042E7,
    "z" : -5390.419947506562
  }, {
    "x" : 1798453.7401574801,
    "y" : 2.5044123031496063E7,
    "z" : -5395.997375328084
  }, {
    "x" : 1788395.9973753279,
    "y" : 2.505090649606299E7,
    "z" : -5406.824146981627
  }, {
    "x" : 1794440.6167979,
    "y" : 2.5046503280839894E7,
    "z" : -5392.716535433071
  }, {
    "x" : 1786367.4540682416,
    "y" : 2.5062931430446193E7,
    "z" : -5452.755905511811
  }, {
    "x" : 1788224.7375328084,
    "y" : 2.5057265748031493E7,
    "z" : -5404.85564304462
  }, {
    "x" : 1789879.2650918632,
    "y" : 2.50643156167979E7,
    "z" : -5464.238845144357
  }, {
    "x" : 1796062.6640419948,
    "y" : 2.5055903871391077E7,
    "z" : -5512.795275590551
  }, {
    "x" : 1789700.1312335955,
    "y" : 2.5059661089238845E7,
    "z" : -5548.884514435695
  }, {
    "x" : 1796443.2414698163,
    "y" : 2.5047924212598424E7,
    "z" : -5404.199475065617
  }, {
    "x" : 1782251.968503937,
    "y" : 2.505876902887139E7,
    "z" : -5779.85564304462
  }, {
    "x" : 1793879.2650918635,
    "y" : 2.5047021325459316E7,
    "z" : -5394.028871391076
  }, {
    "x" : 1795888.1233595798,
    "y" : 2.5046238845144354E7,
    "z" : -5369.422572178477
  }, {
    "x" : 1794775.2624671916,
    "y" : 2.5049992782152228E7,
    "z" : -5404.527559055117
  }, {
    "x" : 1793214.2388451442,
    "y" : 2.5048931102362204E7,
    "z" : -5332.677165354331
  }, {
    "x" : 1797323.490813648,
    "y" : 2.5047011811023623E7,
    "z" : -5422.900262467192
  }, {
    "x" : 1789103.3464566926,
    "y" : 2.505270866141732E7,
    "z" : -5341.535433070866
  }, {
    "x" : 1788217.847769029,
    "y" : 2.505421062992126E7,
    "z" : -5350.0656167979005
  }, {
    "x" : 1789805.4461942255,
    "y" : 2.5062502952755906E7,
    "z" : -5399.278215223097
  }, {
    "x" : 1788417.3228346454,
    "y" : 2.5061791994750656E7,
    "z" : -5383.202099737532
  } ]
} ]

GET /public/api/v1/polygons/{uuid}/data

Path parameter Description
uuid Polygon UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
[].label String Polyline label, an empty string if the label is not set
[].points_count Number Number of points in the polyline
[].xyz_points Array Polyline XYZ points
[].xyz_points[].x Number Point X coordinate (project units)
[].xyz_points[].y Number Point Y coordinate (project units)
[].xyz_points[].z Number Point Z coordinate (project depth units)

Upload polygon data to GP

Upload polygon data by polygon UUID, replacing all polylines of the polygon. The body is an array of polylines, a polyline with an empty xyz_points array is skipped. An unreadable body, for example a polyline without xyz_points, is rejected with 406. If the data cannot be saved, the error status of the Solo data service is returned (type INVALID_REQUEST). Coordinates are in project units. Requires the Update permission in the global project

Request

$ curl 'https://solo.cloud/public/api/v1/polygons/19af44c4-58b5-45b2-818e-8814ef5382d6/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '[ {
  "label" : "polyline1",
  "xyz_points" : [ {
    "x" : 178821.8,
    "y" : 250542.6,
    "z" : -5350.0
  }, {
    "x" : 178980.4,
    "y" : 250625.7,
    "z" : -5399.2
  }, {
    "x" : 178841.3,
    "y" : 250617.9,
    "z" : -5383.5
  } ]
}, {
  "xyz_points" : [ {
    "x" : 17.0,
    "y" : 25.0,
    "z" : -53.1
  }, {
    "x" : 11.0,
    "y" : 225.7,
    "z" : -154.0
  } ]
} ]'

PUT /public/api/v1/polygons/19af44c4-58b5-45b2-818e-8814ef5382d6/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 384

[ {
  "label" : "polyline1",
  "xyz_points" : [ {
    "x" : 178821.8,
    "y" : 250542.6,
    "z" : -5350.0
  }, {
    "x" : 178980.4,
    "y" : 250625.7,
    "z" : -5399.2
  }, {
    "x" : 178841.3,
    "y" : 250617.9,
    "z" : -5383.5
  } ]
}, {
  "xyz_points" : [ {
    "x" : 17.0,
    "y" : 25.0,
    "z" : -53.1
  }, {
    "x" : 11.0,
    "y" : 225.7,
    "z" : -154.0
  } ]
} ]

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: d9081cd30bae2126fd70c42c0aa32034

PUT /public/api/v1/polygons/{uuid}/data

Path parameter Description
uuid Polygon UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
[].label String Polyline label
[].xyz_points Array Polyline XYZ points. A polyline with an empty array is skipped
[].xyz_points[].x Number Point X coordinate (project units)
[].xyz_points[].y Number Point Y coordinate (project units)
[].xyz_points[].z Number Point Z coordinate (project depth units)

Response body

Empty body

Upload polygon data to VP

Upload polygon data by polygon UUID and virtual project UUID, with the same body and rules as Upload polygon data to GP. The polygon must belong to the global project of the virtual project, otherwise 400 is returned. The Update permission is checked in the virtual project. Polygon data is shared, so the upload replaces the data seen in the global project and in all its virtual projects. If the polygon had no data before, it is also added to the given virtual project

Request

$ curl 'https://solo.cloud/public/api/v1/projects/c7f82958-d698-4d6c-acc2-9692a858b756/polygons/a2883494-14a7-4ed0-af8e-49431db75bcd/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '[ {
  "label" : "polyline1",
  "xyz_points" : [ {
    "x" : 178821.8,
    "y" : 250542.6,
    "z" : -5350.0
  }, {
    "x" : 178980.4,
    "y" : 250625.7,
    "z" : -5399.2
  }, {
    "x" : 178841.3,
    "y" : 250617.9,
    "z" : -5383.5
  } ]
}, {
  "xyz_points" : [ {
    "x" : 17.0,
    "y" : 25.0,
    "z" : -53.1
  }, {
    "x" : 11.0,
    "y" : 225.7,
    "z" : -154.0
  } ]
} ]'

PUT /public/api/v1/projects/c7f82958-d698-4d6c-acc2-9692a858b756/polygons/a2883494-14a7-4ed0-af8e-49431db75bcd/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 384

[ {
  "label" : "polyline1",
  "xyz_points" : [ {
    "x" : 178821.8,
    "y" : 250542.6,
    "z" : -5350.0
  }, {
    "x" : 178980.4,
    "y" : 250625.7,
    "z" : -5399.2
  }, {
    "x" : 178841.3,
    "y" : 250617.9,
    "z" : -5383.5
  } ]
}, {
  "xyz_points" : [ {
    "x" : 17.0,
    "y" : 25.0,
    "z" : -53.1
  }, {
    "x" : 11.0,
    "y" : 225.7,
    "z" : -154.0
  } ]
} ]

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 865ef1df3b88d2b5d630475475cd3d7c

PUT /public/api/v1/projects/{projectUuid}/polygons/{polygonUuid}/data

Path parameter Description
projectUuid Virtual project UUID
polygonUuid UUID of a polygon of the global project of the virtual project
Header Description
Authorization OAuth2 authorization header
Body field Type Description
[].label String Polyline label
[].xyz_points Array Polyline XYZ points. A polyline with an empty array is skipped
[].xyz_points[].x Number Point X coordinate (project units)
[].xyz_points[].y Number Point Y coordinate (project units)
[].xyz_points[].z Number Point Z coordinate (project depth units)

Response body

Empty body

18. Sticks

Create stick

Create stick with its trajectory by project UUID (a virtual project UUID is also accepted, the stick is then added to the virtual project). Coordinates and TVDSS are in project units. The trajectory must contain at least one point

Request

$ curl 'https://solo.cloud/public/api/v1/projects/5381c3ce-254b-47ca-8d4b-f083e6b29638/sticks' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Stick name",
  "trajectory" : [ {
    "tvdss" : {
      "undefined" : true
    },
    "type" : "SHL",
    "x" : {
      "undefined" : true
    },
    "y" : {
      "undefined" : true
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "LP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -305263.133640553
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "TD",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -300263.133640553
    }
  } ]
}'

POST /public/api/v1/projects/5381c3ce-254b-47ca-8d4b-f083e6b29638/sticks HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 548

{
  "name" : "Stick name",
  "trajectory" : [ {
    "tvdss" : {
      "undefined" : true
    },
    "type" : "SHL",
    "x" : {
      "undefined" : true
    },
    "y" : {
      "undefined" : true
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "LP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -305263.133640553
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "TD",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -300263.133640553
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: d228733a96f137a5516e8b4f45cb8d07
Content-Type: application/json

{
  "uuid" : "1c7795a1-eefd-47ec-ae76-4e89c423fac6"
}

POST /public/api/v1/projects/{uuid}/sticks

Path parameter Description
uuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Stick name. Must not be blank, up to 200 characters
trajectory Array Trajectory points in order, see type for the order rules
trajectory[].x.val Number X coordinate (project units)
trajectory[].y.val Number Y coordinate (project units)
trajectory[].tvdss.val Number True vertical depth below sea level (project units)
trajectory[].type String Required. Point type (possible values: SHL for Surface Hole Location, LP for Landing Point, TD for Total Depth, WP). SHL must be the first point. LP and TD are optional and allowed once each, TD must be the last point and requires a preceding LP. A point without a type or a trajectory that breaks these rules is rejected with 406

Response body

Path Type Description
uuid String Created stick UUID

Get sticks by project

Get a list of sticks with their trajectories by project UUID with pagination, in creation order. For a virtual project UUID, only sticks of the virtual project are returned

Request

$ curl 'https://solo.cloud/public/api/v1/projects/5381c3ce-254b-47ca-8d4b-f083e6b29638/sticks?offset=0&limit=10&filter=oNe' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/5381c3ce-254b-47ca-8d4b-f083e6b29638/sticks?offset=0&limit=10&filter=oNe HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 0eb8b1a0edb59974f5f0e07e31d5f251
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "e9343dbe-b41e-47c0-8f41-e75f73e67dc8",
    "name" : "Stick one",
    "trajectory" : [ {
      "type" : "SHL",
      "x" : {
        "val" : 0.8697269212225636
      },
      "y" : {
        "val" : 0.5272655729951436
      },
      "tvdss" : {
        "val" : 2.338151248976979
      }
    }, {
      "type" : "LP",
      "x" : {
        "val" : 0.4407804009091818
      },
      "y" : {
        "val" : 0.7214381055218748
      },
      "tvdss" : {
        "val" : 0.6363172331120134
      }
    }, {
      "type" : "TD",
      "x" : {
        "val" : 0.7499624079379061
      },
      "y" : {
        "val" : 0.4386324438811108
      },
      "tvdss" : {
        "val" : 0.11194701294133279
      }
    } ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{uuid}/sticks

Path parameter Description
uuid Project UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the sticks whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Stick UUID
content[].name String Stick name
content[].trajectory Array Trajectory points
content[].trajectory[].x.val Number X coordinate (project units)
content[].trajectory[].y.val Number Y coordinate (project units)
content[].trajectory[].tvdss.val Number True vertical depth below sea level (project units)
content[].trajectory[].type String Point type (possible values: SHL for Surface Hole Location, LP for Landing Point, TD for Total Depth, WP)

Update stick

Replace the name and the trajectory of a stick by UUID. Both name and trajectory are required, the trajectory is replaced as a whole

Request

$ curl 'https://solo.cloud/public/api/v1/sticks/e9343dbe-b41e-47c0-8f41-e75f73e67dc8' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Updated stick name",
  "trajectory" : [ {
    "tvdss" : {
      "undefined" : true
    },
    "type" : "SHL",
    "x" : {
      "undefined" : true
    },
    "y" : {
      "undefined" : true
    }
  }, {
    "tvdss" : {
      "val" : -1524
    },
    "type" : "WP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -305263.133640553
    }
  }, {
    "tvdss" : {
      "val" : -2286
    },
    "type" : "WP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -305263.133640553
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "LP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -305263.133640553
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "WP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -301513.133640553
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "TD",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -300263.133640553
    }
  } ]
}'

PATCH /public/api/v1/sticks/e9343dbe-b41e-47c0-8f41-e75f73e67dc8 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 1063

{
  "name" : "Updated stick name",
  "trajectory" : [ {
    "tvdss" : {
      "undefined" : true
    },
    "type" : "SHL",
    "x" : {
      "undefined" : true
    },
    "y" : {
      "undefined" : true
    }
  }, {
    "tvdss" : {
      "val" : -1524
    },
    "type" : "WP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -305263.133640553
    }
  }, {
    "tvdss" : {
      "val" : -2286
    },
    "type" : "WP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -305263.133640553
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "LP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -305263.133640553
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "WP",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -301513.133640553
    }
  }, {
    "tvdss" : {
      "val" : -3048
    },
    "type" : "TD",
    "x" : {
      "val" : 617886.755760369
    },
    "y" : {
      "val" : -300263.133640553
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3d9a747aad2ad65b469e27acdcbae731

PATCH /public/api/v1/sticks/{uuid}

Path parameter Description
uuid Stick UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Stick name. Must not be blank, up to 200 characters
trajectory Array Trajectory points in order, see type for the order rules
trajectory[].x.val Number X coordinate (project units)
trajectory[].y.val Number Y coordinate (project units)
trajectory[].tvdss.val Number True vertical depth below sea level (project units)
trajectory[].type String Required. Point type (possible values: SHL for Surface Hole Location, LP for Landing Point, TD for Total Depth, WP). SHL must be the first point. LP and TD are optional and allowed once each, TD must be the last point and requires a preceding LP. A point without a type or a trajectory that breaks these rules is rejected with 406

Response body

Empty body

Delete stick

Delete stick by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/sticks/a5e403f7-931e-41a0-8890-e0e5054b9d5e' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/sticks/a5e403f7-931e-41a0-8890-e0e5054b9d5e HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 323bef03ddabb33d4e0db1fb6733e292

DELETE /public/api/v1/sticks/{uuid}

Path parameter Description
uuid Stick UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

19. Earth models

Create earth model

Create earth model by interpretation UUID. The earth model is created without data and is not listed by Get earth models by interpretation until its data is uploaded. Returns 403 if the interpretation is locked or is a private interpretation of another user. A service (AUTO) interpretation is rejected with 400

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/912592b7-9fb2-4150-93a5-a1585b8a6d7d/earthmodels' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Earth model name"
}'

POST /public/api/v1/interpretations/912592b7-9fb2-4150-93a5-a1585b8a6d7d/earthmodels HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 33

{
  "name" : "Earth model name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ca1a407ed4988765c344d54d34325cf3
Content-Type: application/json

{
  "uuid" : "4c511bc5-9445-4243-a728-d98ba79c9c31"
}

POST /public/api/v1/interpretations/{uuid}/earthmodels

Path parameter Description
uuid Interpretation UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Earth model name, required, not blank, at most 200 characters

Response body

Path Type Description
uuid String Created earth model UUID

Get earth models by interpretation

Get a list of earth models by interpretation UUID with pagination, sorted by name. Earth models that do not contain data will not be included in the response

Request

$ curl 'https://solo.cloud/public/api/v1/interpretations/912592b7-9fb2-4150-93a5-a1585b8a6d7d/earthmodels?offset=0&limit=10&filter=EM' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/interpretations/912592b7-9fb2-4150-93a5-a1585b8a6d7d/earthmodels?offset=0&limit=10&filter=EM HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 0cfee611853e71f6ba7cf63781e346f2
Content-Type: application/json

{
  "content" : [ {
    "name" : "EM 1",
    "uuid" : "79883734-fbc1-482c-87a1-32cf2ff3b2d0"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/interpretations/{uuid}/earthmodels

Path parameter Description
uuid Interpretation UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the earth models whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Earth model UUID
content[].name String Earth model name

Get earth model data

Get earth model data by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/earthmodels/79883734-fbc1-482c-87a1-32cf2ff3b2d0/data' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/earthmodels/79883734-fbc1-482c-87a1-32cf2ff3b2d0/data HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: d4a24f0ce3e1cf60f018cf8e08be0e75
Content-Type: application/json

{
  "sections" : [ {
    "layers" : [ ],
    "md" : {
      "val" : 0.0
    }
  }, {
    "layers" : [ ],
    "md" : {
      "val" : 328.0839895013124
    }
  } ]
}

GET /public/api/v1/earthmodels/{uuid}/data

Path parameter Description
uuid Earth model UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
sections Array Earth model sections
sections[].md.val Number Measured Depth value (project units)
sections[].layers Array Earth model section layers
sections[].layers[].resistivity_horizontal.val Number Horizontal resistivity value
sections[].layers[].resistivity_vertical.val Number Vertical resistivity value
sections[].layers[].tvd.val Number True vertical depth value (project units)

Upload earth model data

Upload earth model data by UUID. The uploaded sections replace the current data of the earth model, depths are in project units. Every section requires md and layers, every layer requires tvd, resistivity_horizontal and resistivity_vertical. md and the layer values are double value objects. A request that breaks these rules is rejected with 400. Returns 403 if the interpretation is locked or is a private interpretation of another user. A service (AUTO) interpretation is rejected with 400

Request

$ curl 'https://solo.cloud/public/api/v1/earthmodels/79883734-fbc1-482c-87a1-32cf2ff3b2d0/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "sections" : [ {
    "layers" : [ {
      "resistivity_horizontal" : {
        "val" : 10.0
      },
      "resistivity_vertical" : {
        "val" : 10.0
      },
      "tvd" : {
        "val" : -100000
      }
    }, {
      "resistivity_horizontal" : {
        "val" : 994.0
      },
      "resistivity_vertical" : {
        "val" : 1988.0
      },
      "tvd" : {
        "val" : 16.4592
      }
    }, {
      "resistivity_horizontal" : {
        "val" : 994.0
      },
      "resistivity_vertical" : {
        "val" : 1988.0
      },
      "tvd" : {
        "val" : 30.48
      }
    } ],
    "md" : {
      "val" : 10.0
    }
  }, {
    "layers" : [ {
      "resistivity_horizontal" : {
        "val" : 20.0
      },
      "resistivity_vertical" : {
        "val" : 20.0
      },
      "tvd" : {
        "val" : -100000
      }
    }, {
      "resistivity_horizontal" : {
        "val" : 99.0
      },
      "resistivity_vertical" : {
        "val" : 988.0
      },
      "tvd" : {
        "val" : 31
      }
    } ],
    "md" : {
      "val" : 30.0
    }
  } ]
}'

PUT /public/api/v1/earthmodels/79883734-fbc1-482c-87a1-32cf2ff3b2d0/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 1074

{
  "sections" : [ {
    "layers" : [ {
      "resistivity_horizontal" : {
        "val" : 10.0
      },
      "resistivity_vertical" : {
        "val" : 10.0
      },
      "tvd" : {
        "val" : -100000
      }
    }, {
      "resistivity_horizontal" : {
        "val" : 994.0
      },
      "resistivity_vertical" : {
        "val" : 1988.0
      },
      "tvd" : {
        "val" : 16.4592
      }
    }, {
      "resistivity_horizontal" : {
        "val" : 994.0
      },
      "resistivity_vertical" : {
        "val" : 1988.0
      },
      "tvd" : {
        "val" : 30.48
      }
    } ],
    "md" : {
      "val" : 10.0
    }
  }, {
    "layers" : [ {
      "resistivity_horizontal" : {
        "val" : 20.0
      },
      "resistivity_vertical" : {
        "val" : 20.0
      },
      "tvd" : {
        "val" : -100000
      }
    }, {
      "resistivity_horizontal" : {
        "val" : 99.0
      },
      "resistivity_vertical" : {
        "val" : 988.0
      },
      "tvd" : {
        "val" : 31
      }
    } ],
    "md" : {
      "val" : 30.0
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 7dc71cb21c6b48d6ae4f30574655c973

PUT /public/api/v1/earthmodels/{uuid}/data

Path parameter Description
uuid Earth model UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
sections Array Earth model sections
sections[].md.val Number Measured Depth value (project units)
sections[].layers Array Earth model section layers
sections[].layers[].resistivity_horizontal.val Number Horizontal resistivity value
sections[].layers[].resistivity_vertical.val Number Vertical resistivity value
sections[].layers[].tvd.val Number True vertical depth value (project units)

Response body

Empty body

20. Reference lists

Get reference list categories

Get a list of reference list categories

Request

$ curl 'https://solo.cloud/public/api/v1/referencelistcategories' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/referencelistcategories HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 9be187f71127b525f6250e8eaf82168f
Content-Type: application/json

[ {
  "name" : "welllist",
  "uuid" : "f6665da9-e922-42a7-ae92-a45a5b367eaf",
  "applicable_to" : [ "laterals", "typewells" ]
} ]

GET /public/api/v1/referencelistcategories

Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
[].name String Reference list category name
[].uuid String Reference list category UUID
[].applicable_to Array Object types the category applies to, for example laterals, typewells

Get reference lists with items

Get a list of reference lists with the UUIDs of their objects by project UUID and category UUID with pagination, sorted by name. For a virtual project UUID, only lists of the virtual project are returned and object_ids contains only objects included in it. Returns 404 for an unknown category

Request

$ curl 'https://solo.cloud/public/api/v1/projects/3865ed2e-9f1b-446a-92f1-3b30f497000d/listcategories/f6665da9-e922-42a7-ae92-a45a5b367eaf/referencelists?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/3865ed2e-9f1b-446a-92f1-3b30f497000d/listcategories/f6665da9-e922-42a7-ae92-a45a5b367eaf/referencelists?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: cb4ea989e606c97ccce9a5123e0ba256
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "78b05d2f-29a8-402f-8336-50a3440bd82f",
    "name" : "name",
    "owner" : {
      "description" : "",
      "email" : "a.zhuravlev+support@rogii.com",
      "first_name" : "AAAAAA",
      "last_name" : "BBB"
    },
    "object_ids" : [ ]
  }, {
    "uuid" : "85336cd8-4f83-4149-8a9d-a4d26be9c662",
    "name" : "Reference List Name",
    "owner" : {
      "description" : "Bot manager",
      "email" : "a.bortnikov+manager@rogii.com",
      "first_name" : "Bot",
      "last_name" : "Manager"
    },
    "object_ids" : [ "4848d8e3-4fe1-4ccf-8aa6-42ded556afea", "14ea9a36-38b0-4afc-89d7-8432a1222889" ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{projectUuid}/listcategories/{categoryUuid}/referencelists

Path parameter Description
projectUuid Project UUID (a virtual project UUID is also accepted)
categoryUuid Reference list category UUID, see Get reference list categories
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Reference list UUID
content[].name String Reference list name
content[].object_ids Array UUIDs of the objects in the list. For a virtual project, only objects included in the virtual project
content[].owner Object User info of the reference list owner (absent if the list has no owner or the owner user no longer exists)
content[].owner.description String User description
content[].owner.email String User email
content[].owner.first_name String User first name
content[].owner.last_name String User last name

Get well lists with items

Get a list of well lists with the UUIDs of their objects by project UUID with pagination, sorted by name. For a virtual project UUID, only well lists of the virtual project are returned and object_ids contains only objects included in it

Request

$ curl 'https://solo.cloud/public/api/v1/projects/3865ed2e-9f1b-446a-92f1-3b30f497000d/welllists?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/3865ed2e-9f1b-446a-92f1-3b30f497000d/welllists?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ff19b964ecfc674797b156d107025de7
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "78b05d2f-29a8-402f-8336-50a3440bd82f",
    "name" : "name",
    "owner" : {
      "description" : "",
      "email" : "a.zhuravlev+support@rogii.com",
      "first_name" : "AAAAAA",
      "last_name" : "BBB"
    },
    "object_ids" : [ ]
  }, {
    "uuid" : "85336cd8-4f83-4149-8a9d-a4d26be9c662",
    "name" : "Reference List Name",
    "owner" : {
      "description" : "Bot manager",
      "email" : "a.bortnikov+manager@rogii.com",
      "first_name" : "Bot",
      "last_name" : "Manager"
    },
    "object_ids" : [ "4848d8e3-4fe1-4ccf-8aa6-42ded556afea", "14ea9a36-38b0-4afc-89d7-8432a1222889" ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{projectUuid}/welllists

Path parameter Description
projectUuid Project UUID (a virtual project UUID is also accepted)
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Well list UUID
content[].name String Well list name
content[].object_ids Array UUIDs of the objects in the well list. For a virtual project, only objects included in the virtual project
content[].owner Object User info of the well list owner (absent if the list has no owner or the owner user no longer exists)
content[].owner.description String User description
content[].owner.email String User email
content[].owner.first_name String User first name
content[].owner.last_name String User last name

Get well list wells

Get wells of a well list by well list UUID, sorted by name. Available to any user of the company that owns the well list's project. Returns 404 if the list does not exist, is not a well list or belongs to another company

Request

$ curl 'https://solo.cloud/public/api/v1/welllists/85336cd8-4f83-4149-8a9d-a4d26be9c662' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/welllists/85336cd8-4f83-4149-8a9d-a4d26be9c662 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 7b648e2fd2c055347bcf2ad42b5b4053
Content-Type: application/json

{
  "name" : "Reference List Name",
  "owner" : {
    "description" : "Bot manager",
    "email" : "a.bortnikov+manager@rogii.com",
    "first_name" : "Bot",
    "last_name" : "Manager"
  },
  "wells" : [ {
    "name" : "Lateral 22H",
    "api" : "42-501-20130",
    "uuid" : "4848d8e3-4fe1-4ccf-8aa6-42ded556afea",
    "type" : "WELL"
  }, {
    "name" : "Typewell A",
    "uuid" : "14ea9a36-38b0-4afc-89d7-8432a1222889",
    "type" : "TYPEWELL"
  } ]
}

GET /public/api/v1/welllists/{uuid}

Path parameter Description
uuid Well list UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
name String Well list name
owner Object User info of the well list owner (absent if the list has no owner or the owner user no longer exists)
owner.description String User description
owner.email String User email
owner.first_name String User first name
owner.last_name String User last name
wells Array Wells included in the well list, sorted by name
wells[].name String Well name
wells[].api String Well API number (absent if not set)
wells[].uuid String Well UUID
wells[].type String Well type: WELL, TYPEWELL or NESTEDWELL

21. Comments

Create comment

Create comment by lateral UUID, returns its UUID. Comment names do not have to be unique

Request

$ curl 'https://solo.cloud/public/api/v1/wells/872d517c-7fb2-4ee4-92f5-212e8c99b0f6/comments' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Comment name"
}'

POST /public/api/v1/wells/872d517c-7fb2-4ee4-92f5-212e8c99b0f6/comments HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 29

{
  "name" : "Comment name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 293fcf01837a583f706f9b7bfb15781b
Content-Type: application/json

{
  "uuid" : "ee383bb2-3208-4b88-840c-73e0d94cb214"
}

POST /public/api/v1/wells/{uuid}/comments

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Comment name, required, not blank, up to 200 characters

Response body

Path Type Description
uuid String Created comment UUID

Create comment box

Create comment box by comment UUID, returns its UUID. anchor_md is in project depth units, when it is omitted the box has no MD anchor

Request

$ curl 'https://solo.cloud/public/api/v1/comments/382ecbf0-a4a9-4964-9fbe-94a4db4099a0/commentboxes' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "text" : "Comment box text",
  "anchor_md" : {
    "val" : 1205.8
  }
}'

POST /public/api/v1/comments/382ecbf0-a4a9-4964-9fbe-94a4db4099a0/commentboxes HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 75

{
  "text" : "Comment box text",
  "anchor_md" : {
    "val" : 1205.8
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ab854a647c372311730b00dadc20fe5c
Content-Type: application/json

{
  "uuid" : "5267eeca-01a3-491b-8300-2bc22a121005"
}

POST /public/api/v1/comments/{uuid}/commentboxes

Path parameter Description
uuid Comment UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
text String Comment box text, up to 8192 characters
anchor_md.val Number Comment box placement measured depth value in project units

Response body

Path Type Description
uuid String Created comment box UUID

Get comments

Get comments with comment boxes by lateral UUID with pagination, in creation order. anchor_md is returned in project depth units

Request

$ curl 'https://solo.cloud/public/api/v1/wells/872d517c-7fb2-4ee4-92f5-212e8c99b0f6/comments?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

GET /public/api/v1/wells/872d517c-7fb2-4ee4-92f5-212e8c99b0f6/comments?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 451674d3c18b7d923b7e05348a0dcdb0
Content-Type: application/json

{
  "content" : [ {
    "comment_id" : "382ecbf0-a4a9-4964-9fbe-94a4db4099a0",
    "name" : "Updated comment name",
    "comment_boxes" : [ {
      "commentbox_id" : "210dce66-4996-4caa-b075-ff85010f9386",
      "text" : "New Comment Text",
      "anchor_md" : {
        "val" : 2375.2755905511813
      }
    }, {
      "commentbox_id" : "5267eeca-01a3-491b-8300-2bc22a121005",
      "text" : "Comment box text",
      "anchor_md" : {
        "val" : 1205.8
      }
    } ]
  }, {
    "comment_id" : "a4b6ccfe-f55f-479e-8c9f-be6464f537b3",
    "name" : "Comment",
    "comment_boxes" : [ {
      "commentbox_id" : "2b99387a-898b-4212-b052-3278c12a2b80",
      "text" : "New Comment Text",
      "anchor_md" : {
        "val" : 2375.2755905511813
      }
    }, {
      "commentbox_id" : "6a838de7-a460-4cc0-ae79-90d2651f3752",
      "text" : "New Comment Text",
      "anchor_md" : {
        "val" : 2375.2755905511813
      }
    } ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/comments

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].comment_id String Comment UUID
content[].name String Comment name
content[].comment_boxes[].commentbox_id String Comment box UUID
content[].comment_boxes[].text String Comment box text
content[].comment_boxes[].anchor_md.val Number Comment box placement measured depth value in project units

Update comment

Rename comment by UUID. name is required

Request

$ curl 'https://solo.cloud/public/api/v1/comments/382ecbf0-a4a9-4964-9fbe-94a4db4099a0' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Updated comment name"
}'

PATCH /public/api/v1/comments/382ecbf0-a4a9-4964-9fbe-94a4db4099a0 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 37

{
  "name" : "Updated comment name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: efae0d35c1f83b04090d978e503d851b

PATCH /public/api/v1/comments/{uuid}

Path parameter Description
uuid Comment UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String New comment name, required, not blank, up to 200 characters

Response body

Empty body

Update comment box

Update comment box by UUID. Omitted fields are not changed. Setting text discards the rich text formatting of the box

Request

$ curl 'https://solo.cloud/public/api/v1/commentboxes/210dce66-4996-4caa-b075-ff85010f9386' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "text" : "Updated comment box text",
  "anchor_md" : {
    "val" : 333.8
  }
}'

PATCH /public/api/v1/commentboxes/210dce66-4996-4caa-b075-ff85010f9386 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 82

{
  "text" : "Updated comment box text",
  "anchor_md" : {
    "val" : 333.8
  }
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 4e262a290d8db589188818ea5285d4d4

PATCH /public/api/v1/commentboxes/{uuid}

Path parameter Description
uuid Comment box UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
text String New comment box text, up to 8192 characters. Not changed when omitted, setting it discards the rich text formatting of the box
anchor_md.val Number New comment box placement measured depth value in project units. Not changed when anchor_md is omitted

Response body

Empty body

Delete comment

Delete comment by UUID together with all its comment boxes

Request

$ curl 'https://solo.cloud/public/api/v1/comments/382ecbf0-a4a9-4964-9fbe-94a4db4099a0' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/comments/382ecbf0-a4a9-4964-9fbe-94a4db4099a0 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 63f6a3304c67a8376b061afab1126f79

DELETE /public/api/v1/comments/{uuid}

Path parameter Description
uuid Comment UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Delete comment box

Delete comment box by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/commentboxes/210dce66-4996-4caa-b075-ff85010f9386' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json'

DELETE /public/api/v1/commentboxes/210dce66-4996-4caa-b075-ff85010f9386 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: af0b0155f12772e366c9cea69f4013e8

DELETE /public/api/v1/commentboxes/{uuid}

Path parameter Description
uuid Comment box UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

22. Log families

Get laterals log families list

Get log families of the project that match at least one lateral log, with pagination, in creation order. A log matches a log family when the log name equals one of the family mnemonics, case-insensitive. Mudlog and image log families are not returned

Request

$ curl 'https://solo.cloud/public/api/v1/projects/85f942d5-b3da-4d96-a231-11d127d01915/wells/logs/logfamilies?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/85f942d5-b3da-4d96-a231-11d127d01915/wells/logs/logfamilies?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 749e014276c8c1bf359a07b484dd55b0
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "b7d4d57d-f411-4806-9317-e13983dffebf",
    "name" : "Log Family",
    "group_mnemonics" : [ "mnemonic1", "mnemonic2", "mnemonic3" ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{uuid}/wells/logs/logfamilies

Path parameter Description
uuid Project UUID (a virtual project UUID is also accepted)
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the log families whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Log family UUID
content[].name String Log family name
content[].group_mnemonics Array Mnemonics list

Get typewells log families list

Get log families of the project that match at least one typewell log, with pagination, in creation order. A log matches a log family when the log name equals one of the family mnemonics, case-insensitive. Mudlog and image log families are not returned

Request

$ curl 'https://solo.cloud/public/api/v1/projects/85f942d5-b3da-4d96-a231-11d127d01915/typewells/logs/logfamilies?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/85f942d5-b3da-4d96-a231-11d127d01915/typewells/logs/logfamilies?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: a7e54b65e2d6ed9b7b99120927777263
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "b7d4d57d-f411-4806-9317-e13983dffebf",
    "name" : "Log Family",
    "group_mnemonics" : [ "mnemonic1", "mnemonic2", "mnemonic3" ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{uuid}/typewells/logs/logfamilies

Path parameter Description
uuid Project UUID (a virtual project UUID is also accepted)
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
filter Optional. Returns only the log families whose name contains this substring, case insensitive
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Log family UUID
content[].name String Log family name
content[].group_mnemonics Array Mnemonics list

Get laterals log list by log family in specific project

Get lateral logs of the project that match the log family, that is logs whose name equals one of the family mnemonics, case-insensitive, with pagination, in creation order. Returns 400 if the log family belongs to another project and 404 for an unknown log family

Request

$ curl 'https://solo.cloud/public/api/v1/projects/85f942d5-b3da-4d96-a231-11d127d01915/logfamilies/b7d4d57d-f411-4806-9317-e13983dffebf/wells/logs?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/85f942d5-b3da-4d96-a231-11d127d01915/logfamilies/b7d4d57d-f411-4806-9317-e13983dffebf/wells/logs?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 1631f8d580b5616f6b7293d8d74c05f7
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "d9578aad-0374-4ef3-97fc-be4d1a8a1eb1",
    "name" : "mnemonic1"
  }, {
    "uuid" : "21c438a8-e86d-4163-8df5-9ab28dbbeb35",
    "name" : "mnemonic3"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{project_id}/logfamilies/{log_family_id}/wells/logs

Path parameter Description
project_id Project UUID (a virtual project UUID is also accepted)
log_family_id Log family UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Log UUID
content[].name String Log name

Get typewells log list by log family in specific project

Get typewell logs of the project that match the log family, that is logs whose name equals one of the family mnemonics, case-insensitive, with pagination, in creation order. Returns 400 if the log family belongs to another project and 404 for an unknown log family

Request

$ curl 'https://solo.cloud/public/api/v1/projects/85f942d5-b3da-4d96-a231-11d127d01915/logfamilies/b7d4d57d-f411-4806-9317-e13983dffebf/typewells/logs?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/85f942d5-b3da-4d96-a231-11d127d01915/logfamilies/b7d4d57d-f411-4806-9317-e13983dffebf/typewells/logs?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 8d3a6a4aad450c707fc5cedb8bee8e13
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "9576bd31-f14f-4a56-aa6c-e612659a085b",
    "name" : "mnemonic1"
  }, {
    "uuid" : "14f30680-4910-426e-b92f-b958793a1688",
    "name" : "mnemonic3"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{project_id}/logfamilies/{log_family_id}/typewells/logs

Path parameter Description
project_id Project UUID (a virtual project UUID is also accepted)
log_family_id Log family UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Log UUID
content[].name String Log name

23. Objects update info

Get update info by lateral

Get update info of the lateral and its child objects by lateral UUID. The lateral itself is returned without parent_uuid. Deleted objects are not returned, so a child object missing from the response no longer exists. Only objects of the types listed for type are returned

Request

$ curl 'https://solo.cloud/public/api/v1/wells/53dd8825-1d50-4082-83e9-e58add569133/updateinfo' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/53dd8825-1d50-4082-83e9-e58add569133/updateinfo HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: eae4fea44ec43785d1c0d6cdd68e826d
Content-Type: application/json

{
  "content" : [ {
    "type" : "WELL",
    "modified_at" : "2026-10-06T08:33:26.769776Z",
    "uuid" : "53dd8825-1d50-4082-83e9-e58add569133",
    "updated_at" : "2026-10-06T08:33:25.842894Z"
  }, {
    "type" : "TARGETLINE",
    "modified_at" : "2026-10-06T08:33:26.507724Z",
    "uuid" : "96c9770e-5d85-47e5-b50d-808c6d18901c",
    "updated_at" : "2026-10-06T08:33:26.507724Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "LOG",
    "modified_at" : "2026-10-06T08:33:25.925603Z",
    "uuid" : "15abfdc3-7901-471e-acf3-1e2e1c59a3d7",
    "updated_at" : "2026-10-06T08:33:25.925603Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "IMAGELOG",
    "modified_at" : "2026-10-06T08:33:25.970235Z",
    "uuid" : "675ddd15-16b9-419b-bf04-b471cc8432d0",
    "updated_at" : "2026-10-06T08:33:25.970235Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "EARTHMODEL",
    "modified_at" : "2026-10-06T08:33:26.607555Z",
    "uuid" : "8dfcf945-d22c-40c8-9644-33d24bd29ece",
    "updated_at" : "2026-10-06T08:33:26.570338Z",
    "parent_uuid" : "0eb5715a-ead1-4ac3-a1a4-e5eb01260700"
  }, {
    "type" : "IMAGE",
    "modified_at" : "2026-10-06T08:33:26.027267Z",
    "uuid" : "4ea672af-65f8-4c5b-9a9c-3e4e50f217e2",
    "updated_at" : "2026-10-06T08:33:26.027267Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "INTERPRETATION",
    "modified_at" : "2026-10-06T08:33:26.607555Z",
    "uuid" : "0eb5715a-ead1-4ac3-a1a4-e5eb01260700",
    "updated_at" : "2026-10-06T08:33:26.057411Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "IMAGE",
    "modified_at" : "2026-10-06T08:33:26.191105Z",
    "uuid" : "b3a3b1d3-f259-481f-bae5-8a16371cc0a8",
    "updated_at" : "2026-10-06T08:33:26.191105Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "MUDLOG",
    "modified_at" : "2026-10-06T08:33:26.254114Z",
    "uuid" : "3062ea99-faa9-4f3a-a86a-84589bf78ee0",
    "updated_at" : "2026-10-06T08:33:26.254114Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "NESTEDWELL",
    "modified_at" : "2026-10-06T08:33:26.375452Z",
    "uuid" : "394698a2-3374-4be4-bb0e-dc8c64921a2d",
    "updated_at" : "2026-10-06T08:33:26.348582Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "TOPSET",
    "modified_at" : "2026-10-06T08:33:26.375452Z",
    "uuid" : "bc43ba7b-bdc9-452f-b63c-78f231343a0b",
    "updated_at" : "2026-10-06T08:33:26.375452Z",
    "parent_uuid" : "394698a2-3374-4be4-bb0e-dc8c64921a2d"
  }, {
    "type" : "TOPSET",
    "modified_at" : "2026-10-06T08:33:26.769776Z",
    "uuid" : "88823e10-5a04-47ca-b214-15a972445f92",
    "updated_at" : "2026-10-06T08:33:26.391761Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  }, {
    "type" : "TOP",
    "modified_at" : "2026-10-06T08:33:26.407892Z",
    "uuid" : "405c5d74-f785-4316-a327-84f2d98b0c3e",
    "updated_at" : "2026-10-06T08:33:26.407892Z",
    "parent_uuid" : "88823e10-5a04-47ca-b214-15a972445f92"
  }, {
    "type" : "COMMENT",
    "modified_at" : "2026-10-06T08:33:26.446066Z",
    "uuid" : "89946381-0ddc-4355-bf93-eb4e862e03ea",
    "updated_at" : "2026-10-06T08:33:26.446066Z",
    "parent_uuid" : "53dd8825-1d50-4082-83e9-e58add569133"
  } ]
}

GET /public/api/v1/wells/{uuid}/updateinfo

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
content[].uuid String The object UUID
content[].type String Object type: WELL, TYPEWELL, GRID, POLYGON, STICK, LOG, IMAGE, IMAGELOG, INTERPRETATION, MUDLOG, NESTEDWELL, TOPSET, TOP, COMMENT, TARGETLINE, EARTHMODEL or WELLATTRIBUTE
content[].parent_uuid String Parent object UUID, absent for the requested object itself
content[].updated_at String Timestamp showing when the object itself was updated (UTC time)
content[].modified_at String Timestamp showing when either one of the child objects or object itself was updated (UTC time)

Get update info by typewell

Get update info of the typewell and its child objects by typewell UUID. The typewell itself is returned without parent_uuid. Deleted objects are not returned, so a child object missing from the response no longer exists. Only objects of the types listed for type are returned

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/b336ad60-25f6-4634-8d57-8eedcaa15039/updateinfo' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/b336ad60-25f6-4634-8d57-8eedcaa15039/updateinfo HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 979893a01c496b99f77cfc3c98406634
Content-Type: application/json

{
  "content" : [ {
    "type" : "LOG",
    "modified_at" : "2026-10-06T08:33:25.611965Z",
    "uuid" : "7f752447-3b13-4915-8342-4c894c5fc026",
    "updated_at" : "2026-10-06T08:33:25.611965Z",
    "parent_uuid" : "b336ad60-25f6-4634-8d57-8eedcaa15039"
  }, {
    "type" : "TOPSET",
    "modified_at" : "2026-10-06T08:33:25.780942Z",
    "uuid" : "022b041d-245d-46aa-8b55-040a6a7afdc7",
    "updated_at" : "2026-10-06T08:33:25.643997Z",
    "parent_uuid" : "b336ad60-25f6-4634-8d57-8eedcaa15039"
  }, {
    "type" : "TYPEWELL",
    "modified_at" : "2026-10-06T08:33:25.780942Z",
    "uuid" : "b336ad60-25f6-4634-8d57-8eedcaa15039",
    "updated_at" : "2026-10-06T08:33:25.551655Z"
  }, {
    "type" : "MUDLOG",
    "modified_at" : "2026-10-06T08:33:25.714850Z",
    "uuid" : "95756abe-33f4-4c8c-9672-86ec94713145",
    "updated_at" : "2026-10-06T08:33:25.714850Z",
    "parent_uuid" : "b336ad60-25f6-4634-8d57-8eedcaa15039"
  }, {
    "type" : "TOP",
    "modified_at" : "2026-10-06T08:33:25.780942Z",
    "uuid" : "8d72761a-852e-4709-82ff-d02496a86cc6",
    "updated_at" : "2026-10-06T08:33:25.780942Z",
    "parent_uuid" : "022b041d-245d-46aa-8b55-040a6a7afdc7"
  } ]
}

GET /public/api/v1/typewells/{uuid}/updateinfo

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
content[].uuid String The object UUID
content[].type String Object type: WELL, TYPEWELL, GRID, POLYGON, STICK, LOG, IMAGE, IMAGELOG, INTERPRETATION, MUDLOG, NESTEDWELL, TOPSET, TOP, COMMENT, TARGETLINE, EARTHMODEL or WELLATTRIBUTE
content[].parent_uuid String Parent object UUID, absent for the requested object itself
content[].updated_at String Timestamp showing when the object itself was updated (UTC time)
content[].modified_at String Timestamp showing when either one of the child objects or object itself was updated (UTC time)

Get grid update info

Get grid update info by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/grids/444e4c16-7b25-4510-95f7-4cd1f1082330/updateinfo' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/grids/444e4c16-7b25-4510-95f7-4cd1f1082330/updateinfo HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: db3b45b689f7e151698ced5e651ff9f6
Content-Type: application/json

{
  "content" : [ {
    "type" : "GRID",
    "modified_at" : "2026-10-06T08:33:26.976045Z",
    "uuid" : "444e4c16-7b25-4510-95f7-4cd1f1082330",
    "updated_at" : "2026-10-06T08:33:26.976045Z"
  } ]
}

GET /public/api/v1/grids/{uuid}/updateinfo

Path parameter Description
uuid Grid UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
content[].uuid String The object UUID
content[].type String Object type: WELL, TYPEWELL, GRID, POLYGON, STICK, LOG, IMAGE, IMAGELOG, INTERPRETATION, MUDLOG, NESTEDWELL, TOPSET, TOP, COMMENT, TARGETLINE, EARTHMODEL or WELLATTRIBUTE
content[].parent_uuid String Parent object UUID, absent for the requested object itself
content[].updated_at String Timestamp showing when the object itself was updated (UTC time)
content[].modified_at String Timestamp showing when either one of the child objects or object itself was updated (UTC time)

Get polygon update info

Get polygon update info by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/polygons/8cf6242b-0696-41ed-9d58-67fda8da332f/updateinfo' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/polygons/8cf6242b-0696-41ed-9d58-67fda8da332f/updateinfo HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f3297148a028aa8b213149a8ace2df14
Content-Type: application/json

{
  "content" : [ {
    "type" : "POLYGON",
    "modified_at" : "2026-10-06T08:33:26.895446Z",
    "uuid" : "8cf6242b-0696-41ed-9d58-67fda8da332f",
    "updated_at" : "2026-10-06T08:33:26.895446Z"
  } ]
}

GET /public/api/v1/polygons/{uuid}/updateinfo

Path parameter Description
uuid Polygon UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
content[].uuid String The object UUID
content[].type String Object type: WELL, TYPEWELL, GRID, POLYGON, STICK, LOG, IMAGE, IMAGELOG, INTERPRETATION, MUDLOG, NESTEDWELL, TOPSET, TOP, COMMENT, TARGETLINE, EARTHMODEL or WELLATTRIBUTE
content[].parent_uuid String Parent object UUID, absent for the requested object itself
content[].updated_at String Timestamp showing when the object itself was updated (UTC time)
content[].modified_at String Timestamp showing when either one of the child objects or object itself was updated (UTC time)

Get stick update info

Get stick update info by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/sticks/da980d10-dc09-4ad6-a447-5ad7a17b7cc0/updateinfo' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/sticks/da980d10-dc09-4ad6-a447-5ad7a17b7cc0/updateinfo HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 92aece1b5662a1661d5bca047ab3506b
Content-Type: application/json

{
  "content" : [ {
    "type" : "STICK",
    "modified_at" : "2026-10-06T08:33:27.021932Z",
    "uuid" : "da980d10-dc09-4ad6-a447-5ad7a17b7cc0",
    "updated_at" : "2026-10-06T08:33:27.021932Z"
  } ]
}

GET /public/api/v1/sticks/{uuid}/updateinfo

Path parameter Description
uuid Stick UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
content[].uuid String The object UUID
content[].type String Object type: WELL, TYPEWELL, GRID, POLYGON, STICK, LOG, IMAGE, IMAGELOG, INTERPRETATION, MUDLOG, NESTEDWELL, TOPSET, TOP, COMMENT, TARGETLINE, EARTHMODEL or WELLATTRIBUTE
content[].parent_uuid String Parent object UUID, absent for the requested object itself
content[].updated_at String Timestamp showing when the object itself was updated (UTC time)
content[].modified_at String Timestamp showing when either one of the child objects or object itself was updated (UTC time)

Get last change user info

Get information about users who made the last changes to specified objects. At most 1000 distinct UUIDs are accepted per request (a server setting), otherwise 400 is returned. Objects that are not found in the company of the current user are skipped. Deleted objects are also returned, with their last change before deletion. Objects without a known updating user are skipped

Request

$ curl 'https://solo.cloud/public/api/v1/lastchange/userinfo' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "object_uuids" : [ "53dd8825-1d50-4082-83e9-e58add569133", "b336ad60-25f6-4634-8d57-8eedcaa15039", "444e4c16-7b25-4510-95f7-4cd1f1082330" ]
}'

POST /public/api/v1/lastchange/userinfo HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 145

{
  "object_uuids" : [ "53dd8825-1d50-4082-83e9-e58add569133", "b336ad60-25f6-4634-8d57-8eedcaa15039", "444e4c16-7b25-4510-95f7-4cd1f1082330" ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 82de505bb07ea46ea47541130e187cbe
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "444e4c16-7b25-4510-95f7-4cd1f1082330",
    "type" : "GRID",
    "updated_at" : "2026-10-06T08:33:26.976045Z",
    "modified_at" : "2026-10-06T08:33:26.976045Z",
    "updated_by" : {
      "description" : "Bot manager",
      "email" : "a.bortnikov+manager@rogii.com",
      "first_name" : "Bot",
      "last_name" : "Manager"
    },
    "modified_by" : {
      "description" : "Bot manager",
      "email" : "a.bortnikov+manager@rogii.com",
      "first_name" : "Bot",
      "last_name" : "Manager"
    }
  }, {
    "uuid" : "b336ad60-25f6-4634-8d57-8eedcaa15039",
    "type" : "TYPEWELL",
    "updated_at" : "2026-10-06T08:33:25.551655Z",
    "modified_at" : "2026-10-06T08:33:25.780942Z",
    "updated_by" : {
      "description" : "Bot manager",
      "email" : "a.bortnikov+manager@rogii.com",
      "first_name" : "Bot",
      "last_name" : "Manager"
    },
    "modified_by" : {
      "description" : "Bot manager",
      "email" : "a.bortnikov+manager@rogii.com",
      "first_name" : "Bot",
      "last_name" : "Manager"
    }
  }, {
    "uuid" : "53dd8825-1d50-4082-83e9-e58add569133",
    "type" : "WELL",
    "updated_at" : "2026-10-06T08:33:25.842894Z",
    "modified_at" : "2026-10-06T08:33:26.769776Z",
    "updated_by" : {
      "description" : "Bot manager",
      "email" : "a.bortnikov+manager@rogii.com",
      "first_name" : "Bot",
      "last_name" : "Manager"
    },
    "modified_by" : {
      "description" : "Bot manager",
      "email" : "a.bortnikov+manager@rogii.com",
      "first_name" : "Bot",
      "last_name" : "Manager"
    }
  } ]
}

POST /public/api/v1/lastchange/userinfo

Header Description
Authorization OAuth2 authorization header
Body field Type Description
object_uuids Array List of object UUIDs, at most 1000 distinct values. Objects that are not found in the company of the current user are skipped

Response body

Path Type Description
content Array Content array
content[].uuid String The object UUID
content[].type String Object type, for example WELL, TYPEWELL, GRID or LOG
content[].updated_at String Timestamp showing when the object itself was updated (UTC time)
content[].modified_at String Timestamp showing when either one of the child objects or object itself was updated (UTC time)
content[].updated_by Object User info of who last updated the object
content[].updated_by.description String User description
content[].updated_by.email String User email
content[].updated_by.first_name String User first name
content[].updated_by.last_name String User last name
content[].modified_by Object User info of who last modified the object or its children
content[].modified_by.description String User description
content[].modified_by.email String User email
content[].modified_by.first_name String User first name
content[].modified_by.last_name String User last name

24. Toolcodes

Get toolcodes

Get built-in toolcodes and custom toolcodes of the user's company, sorted by prefix and short_name

Request

$ curl 'https://solo.cloud/public/api/v1/toolcodes' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/toolcodes HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 07c8c6e57b633c8dc0ee4951cd9fbeb3
Content-Type: application/json

[ {
  "short_name" : "MWD+SRGM",
  "description" : "MWD using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with no additional corrections",
  "prefix" : "A001Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+SRGM_Fl",
  "description" : "MWD using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with no additional corrections on a Floating Rig",
  "prefix" : "A001Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+SRGM+SAG",
  "description" : "MWD using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) and Sag Correction",
  "prefix" : "A002Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+SRGM+SAG_Fl",
  "description" : "MWD using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) and Sag Correction on a Floating Rig",
  "prefix" : "A002Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "TEST_TOOLCODE",
  "description" : "A002Mb/ISC4: BGGM dec + sag corrections",
  "prefix" : "A002Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : true
}, {
  "short_name" : "MWD+SRGM+AX",
  "description" : "MWD using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction",
  "prefix" : "A003Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+SRGM+AX_Fl",
  "description" : "MWD using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction on a Floating Rig",
  "prefix" : "A003Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+SRGM+AX+SAG",
  "description" : "MWD using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction and Sag Correction",
  "prefix" : "A004Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+SRGM+AX+SAG_Fl",
  "description" : "MWD using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "A004Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction)",
  "prefix" : "A005Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1_Fl",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) on a Floating Rig",
  "prefix" : "A005Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+AX",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) and Axial Correction",
  "prefix" : "A006Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+AX_Fl",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) and Axial Correction on a Floating Rig",
  "prefix" : "A006Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+AX+SAG",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) and Axial Correction and Sag Correction",
  "prefix" : "A007Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+AX+SAG_Fl",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) and Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "A007Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+MS",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) and Multi-Station Correction. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "A008Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+MS_Fl",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) and Multi-Station Correction on a Floating Rig. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "A008Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+SAG",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) and Sag Correction",
  "prefix" : "A009Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+SAG_Fl",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) and Sag Correction on a Floating Rig",
  "prefix" : "A009Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+SAG+MS",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) with Sag and Multi-Station Correction. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "A010Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR1+SAG+MS_Fl",
  "description" : "MWD with IFR1 (IFR or Crustal Anomaly Correction) with Sag and Multi-Station Correction on a Floating Rig. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "A010Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR2+AX+SAG",
  "description" : "MWD with IFR2 (IIFR or Crustal Anomaly with Time Varying Corrections) and Axial Correction and Sag Correction",
  "prefix" : "A011Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "IFR2",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR2+AX+SAG_Fl",
  "description" : "MWD with IFR2 (IIFR or Crustal Anomaly with Time Varying Corrections) and Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "A011Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "IFR2",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR2+SAG",
  "description" : "MWD with IFR2 (IIFR or Crustal Anomaly with Time Varying Corrections) and Sag Correction",
  "prefix" : "A012Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "IFR2",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR2+SAG_Fl",
  "description" : "MWD with IFR2 (IIFR or Crustal Anomaly with Time Varying Corrections) and Sag Correction on a Floating Rig",
  "prefix" : "A012Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "IFR2",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR2+SAG+MS",
  "description" : "MWD with IFR2 (IIFR or Crustal Anomaly with Time Varying Corrections) with Sag and Multi-Station Correction. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "A013Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "IFR2",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+IFR2+SAG+MS_Fl",
  "description" : "MWD with IFR2 (IIFR or Crustal Anomaly with Time Varying Corrections) with Sag and Multi-Station Correction on a Floating Rig. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "A013Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "IFR2",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+SRGM",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with no additional corrections",
  "prefix" : "A014Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+SRGM_Fl",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with no additional corrections on a Floating Rig",
  "prefix" : "A014Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+SRGM+AX",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction",
  "prefix" : "A015Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+SRGM+AX_Fl",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction on a Floating Rig",
  "prefix" : "A015Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+SRGM+AX+SAG",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction and Sag Correction",
  "prefix" : "A016Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+SRGM+AX+SAG_Fl",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "A016Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+SRGM+SAG",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) and Sag Correction",
  "prefix" : "A017Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+SRGM+SAG_Fl",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) and Sag Correction on a Floating Rig",
  "prefix" : "A017Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "DIPMETER",
  "description" : "Wireline logging tool survey data e.g. Schlumberger GPIT OBDT BGT or Atlas ORIT",
  "prefix" : "A018Mb",
  "tool_category" : "Magnetic",
  "tool_type" : "Dipmeter",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "DIPMETER_Fl",
  "description" : "Wireline logging tool survey data e.g. Schlumberger GPIT OBDT BGT or Atlas ORIT on a Floating Rig",
  "prefix" : "A018Mb",
  "tool_category" : "Magnetic",
  "tool_type" : "Dipmeter",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "GYRO-MWD",
  "description" : "Generic Gyro MWD. CARE TO BE TAKEN - Tool model fails at 90 deg inclination.",
  "prefix" : "A019Gb",
  "tool_category" : "Gyro",
  "tool_type" : "Gyro MWD",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "GYRO-MWD_Fl",
  "description" : "Generic Gyro MWD on a Floating Rig. CARE TO BE TAKEN - Tool model fails at 90 deg inclination.",
  "prefix" : "A019Gb",
  "tool_category" : "Gyro",
  "tool_type" : "Gyro MWD",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "GYRO-NS",
  "description" : "Generic North Seeking Gyrocompass Gyro. CARE TO BE TAKEN - Tool model fails at 90 deg inclination.",
  "prefix" : "A020Gb",
  "tool_category" : "Gyro",
  "tool_type" : "Gyro Compass",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "GYRO-NS_Fl",
  "description" : "Generic North Seeking Gyrocompass Gyro on a Floating Rig. CARE TO BE TAKEN - Tool model fails at 90 deg inclination.",
  "prefix" : "A020Gb",
  "custom" : false
}, {
  "short_name" : "GYRO-NS-CT",
  "description" : "Generic Hybrid Static Gyrocompass and Continuous Survey",
  "prefix" : "A021Gc",
  "tool_category" : "Gyro",
  "tool_type" : "Continuous",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "GYRO-NS-CT_Fl",
  "description" : "Generic Hybrid Static Gyrocompass and Continuous Survey on a Floating Rig",
  "prefix" : "A021Gc",
  "tool_category" : "Gyro",
  "tool_type" : "Continuous",
  "rig_type" : "Floating",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "CB_Film_GMS",
  "description" : "Conventional free gyro e.g. Level Rotor Gyro (LRG). CARE TO BE TAKEN – Tool model fails at 90 deg inclination.",
  "prefix" : "A022Gb",
  "tool_category" : "Gyro",
  "tool_type" : "Camera Based",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "CB_Film_GMS_Fl",
  "description" : "Conventional free gyro e.g. Level Rotor Gyro (LRG) on a Floating Rig. CARE TO BE TAKEN – Tool model fails at 90 deg inclination.",
  "prefix" : "A022Gb",
  "tool_category" : "Gyro",
  "tool_type" : "Camera Based",
  "rig_type" : "Floating",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "CB_Film_GSS",
  "description" : "Conventional free gyro e.g. Level Rotor Gyro (LRG). CARE TO BE TAKEN – Tool model fails at 90 deg inclination.",
  "prefix" : "A023Gb",
  "tool_category" : "Gyro",
  "tool_type" : "Camera Based",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "CB_Film_GSS_Fl",
  "description" : "Conventional free gyro e.g. Level Rotor Gyro (LRG) on a Floating Rig. CARE TO BE TAKEN – Tool model fails at 90 deg inclination.",
  "prefix" : "A023Gb",
  "tool_category" : "Gyro",
  "tool_type" : "Camera Based",
  "rig_type" : "Floating",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "CB_Film_MMS",
  "description" : "Camera Based Film Magnetic Multi-Shot with adequate length and spacing in NMDC",
  "prefix" : "A024Mb",
  "tool_category" : "Magnetic",
  "tool_type" : "Camera Based",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "CB_Film_MMS_Fl",
  "description" : "Camera Based Film Magnetic Multi-Shot with adequate length and spacing in NMDC on a Floating Rig",
  "prefix" : "A024Mb",
  "tool_category" : "Magnetic",
  "tool_type" : "Camera Based",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "CB_Film_MSS",
  "description" : "Camera Based Film Magnetic Single Shot with adequate length and spacing in NMDC",
  "prefix" : "A025Mb",
  "tool_category" : "Magnetic",
  "tool_type" : "Camera Based",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "CB_Film_MSS_Fl",
  "description" : "Camera Based Film Magnetic Single Shot with adequate length and spacing in NMDC on a Floating Rig",
  "prefix" : "A025Mb",
  "tool_category" : "Magnetic",
  "tool_type" : "Camera Based",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "BLIND",
  "description" : "Where no survey information was recorded or where the information no longer exists and there is no other supporting information to justify the use of another error model.",
  "prefix" : "A026Ua",
  "tool_category" : "Utility",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "BLIND_Fl",
  "description" : "Where no survey information was recorded or where the information no longer exists and there is no other supporting information to justify the use of another error model. On a Floating Rig",
  "prefix" : "A026Ua",
  "tool_category" : "Utility",
  "rig_type" : "Floating",
  "revision" : "ISCWSA Rev1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "INC-ONLY",
  "description" : "Inclination only surveys for vertical wells with inclinations less than 5 deg (e.g. Totco Teledrift and Anderdrift)",
  "prefix" : "A027Ub",
  "tool_category" : "Utility",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "INC-ONLY_Fl",
  "description" : "Inclination only surveys for vertical wells with inclinations less than 5 deg (e.g. Totco Teledrift and Anderdrift) on a Floating Rig",
  "prefix" : "A027Ub",
  "tool_category" : "Utility",
  "rig_type" : "Floating",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "INC-ONLY_PLANNED",
  "description" : "Inclination only surveys for planned vertical wells with inclinations less than 5 deg (e.g. Totco Teledrift and Anderdrift)",
  "prefix" : "A028Ub",
  "tool_category" : "Utility",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "INC-ONLY_PLANNED_Fl",
  "description" : "Inclination only surveys for planned vertical wells with inclinations less than 5 deg (e.g. Totco Teledrift and Anderdrift) on a Floating Rig",
  "prefix" : "A028Ub",
  "tool_category" : "Utility",
  "rig_type" : "Floating",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "UNKNOWN",
  "description" : "For use when survey data exists at any interval not exceeding 200ft but the origin or legacy quality of the data is unknown",
  "prefix" : "A029Ub",
  "tool_category" : "Utility",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "UNKNOWN_Fl",
  "description" : "For use when survey data exists at any interval not exceeding 200ft but the origin or legacy quality of the data is unknown. On a Floating Rig",
  "prefix" : "A029Ub",
  "tool_category" : "Utility",
  "rig_type" : "Floating",
  "revision" : "ISCWSA Rev5",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "ZERO-ERROR",
  "description" : "To give zero position uncertainty down to a particular depth.",
  "prefix" : "A030Ua",
  "tool_category" : "Utility",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM",
  "description" : "MWD using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD)",
  "prefix" : "B001Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM_Fl",
  "description" : "MWD using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) on a Floating Rig",
  "prefix" : "B001Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM+AX",
  "description" : "MWD using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) with Axial Correction",
  "prefix" : "B002Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM+AX_Fl",
  "description" : "MWD using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) with Axial Correction on a Floating Rig",
  "prefix" : "B002Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM+AX+SAG",
  "description" : "MWD using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) with Axial Correction and Sag Correction",
  "prefix" : "B003Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM+AX+SAG_Fl",
  "description" : "MWD using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) with Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "B003Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM+SAG",
  "description" : "MWD using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) and Sag Correction",
  "prefix" : "B004Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM+SAG_Fl",
  "description" : "MWD using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) and Sag Correction on a Floating Rig",
  "prefix" : "B004Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM+SAG+MS",
  "description" : "MWD Using a High Resolution Geomagnetic Model (HRGM) with spherical harmonic degree of 720 or higher (e.g. HDGM or MVHD) with Sag Correction and Multi-Station Correction. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "B005Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+HRGM+SAG+MS_Fl",
  "description" : "MWD Using a High Resolution Geomagnetic Model (HRGM) with spherical harmonic degree of 720 or higher (e.g. HDGM or MVHD) with Sag Correction and Multi-Station Correction on a Floating Rig. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "B005Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+LRGM",
  "description" : "MWD using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM)",
  "prefix" : "B006Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+LRGM_Fl",
  "description" : "MWD using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) on a Floating Rig",
  "prefix" : "B006Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+LRGM+AX",
  "description" : "MWD using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Axial Correction",
  "prefix" : "B007Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+LRGM+AX_Fl",
  "description" : "MWD using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Axial Correction on a Floating Rig",
  "prefix" : "B007Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+LRGM+AX+SAG",
  "description" : "MWD using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Axial Correction and Sag Correction",
  "prefix" : "B008Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+LRGM+AX+SAG_Fl",
  "description" : "MWD using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "B008Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+LRGM+SAG",
  "description" : "MWD using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Sag Correction",
  "prefix" : "B009Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "MWD+LRGM+SAG_Fl",
  "description" : "MWD using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Sag Correction on a Floating Rig",
  "prefix" : "B009Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+IFR1+AX+SAG",
  "description" : "EMS with IFR1 (IFR or Crustal Anomaly Correction) and Axial Correction and Sag Correction",
  "prefix" : "B010Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+IFR1+AX+SAG_Fl",
  "description" : "EMS with IFR1 (IFR or Crustal Anomaly Correction) and Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "B010Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+IFR1+SAG",
  "description" : "EMS with IFR1 (IFR or Crustal Anomaly Correction) and Sag Correction",
  "prefix" : "B011Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+IFR1+SAG_Fl",
  "description" : "EMS with IFR1 (IFR or Crustal Anomaly Correction) and Sag Correction on a Floating Rig",
  "prefix" : "B011Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+IFR1+SAG+MS",
  "description" : "EMS with IFR1 (IFR or Crustal Anomaly Correction) with Sag and Multi-Station Correction. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "B012Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+IFR1+SAG+MS_Fl",
  "description" : "EMS with IFR1 (IFR or Crustal Anomaly Correction) with Sag and Multi-Station Correction on a Floating Rig. CARE TO BE TAKEN WHILE PLANNING A WELL – Refer to Survey Management Specialist to ensure MS is valid.",
  "prefix" : "B012Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "MS",
  "geomagnetic_reference" : "IFR1",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+HRGM",
  "description" : "EMS using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD)",
  "prefix" : "B013Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+HRGM_Fl",
  "description" : "EMS using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) on a Floating Rig",
  "prefix" : "B013Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+HRGM+AX",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction",
  "prefix" : "B014Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+HRGM+AX_Fl",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction on a Floating Rig",
  "prefix" : "B014Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+HRGM+AX+SAG",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction and Sag Correction",
  "prefix" : "B015Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+HRGM+AX+SAG_Fl",
  "description" : "EMS using 1-Year Standard Resolution Geomagnetic Mode (e.g. BGGM up to 2018, MVSD) with Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "B015Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+HRGM+SAG",
  "description" : "EMS using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) with Sag Correction",
  "prefix" : "B016Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+HRGM+SAG_Fl",
  "description" : "EMS using 1-year High Resolution Geomagnetic Model with spherical harmonic degree of 720 or higher (e.g. BGGM2019+, HDGM, MVHD) with Sag Correction on a Floating Rig",
  "prefix" : "B016Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "HRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+LRGM",
  "description" : "EMS using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM)",
  "prefix" : "B017Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+LRGM_Fl",
  "description" : "EMS using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) on a Floating Rig",
  "prefix" : "B017Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+LRGM+AX",
  "description" : "EMS using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Axial Correction",
  "prefix" : "B018Md",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+LRGM+AX_Fl",
  "description" : "EMS using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Axial Correction on a Floating Rig",
  "prefix" : "B018Md",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EEMS+LRGM+AX+SAG_Fl",
  "description" : "EMS using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "B019Md",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+LRGM+AX+SAG",
  "description" : "EMS using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Axial Correction and Sag Correction on a Floating Rig",
  "prefix" : "B019Md",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+LRGM+SAG",
  "description" : "EMS using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Sag Correction",
  "prefix" : "B020Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "EMS+LRGM+SAG_Fl",
  "description" : "EMS using Low Resolution Geomagnetic Model (e.g. Updated less frequently than yearly, EMM, CGRF, IGRF, WMM) with Sag Correction on a Floating Rig",
  "prefix" : "B020Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "EMS",
  "rig_type" : "Floating",
  "sag_correction" : "SAG",
  "geomagnetic_reference" : "LRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "FINDS",
  "description" : "Ferranti FINDS Inertial Surveys",
  "prefix" : "B021Ga",
  "tool_category" : "Utility",
  "tool_type" : "Utility",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev1",
  "revision_date" : "2022-09-23",
  "custom" : false
}, {
  "short_name" : "BLIND+TREND",
  "description" : "Where no survey information was recorded but where some other information exists such as the BHA records or Bit-run summaries or some other relevant formation or drilling knowledge exists concerning the expected trends of the wellpath. May only be assigned for specific cases with a Dispensation.",
  "prefix" : "B022Ua",
  "tool_category" : "Utility",
  "tool_type" : "Utility",
  "rig_type" : "Fixed",
  "revision" : "ISCWSA Rev1",
  "revision_date" : "2022-09-23",
  "custom" : false
} ]

GET /public/api/v1/toolcodes

Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
[].short_name String Toolcode short name
[].description String Description
[].prefix String Prefix
[].tool_category String Tool category
[].tool_type String Tool type
[].rig_type String Rig type
[].sag_correction String Sag correction
[].magnetic_correction String Magnetic correction
[].geomagnetic_reference String Geomagnetic reference
[].revision String Revision
[].revision_date String Revision date, yyyy-MM-dd
[].custom Boolean true for a custom toolcode of the user's company, false for a built-in toolcode

Get toolcode terms

Get the error model terms of a built-in or custom toolcode by short name as plain text: the uploaded toolcode file without the lines starting with #. 404 is returned if there is no such toolcode. Encode + in the short name as %2B

Request

$ curl 'https://solo.cloud/public/api/v1/toolcodes/terms?short_name=MWD%252BSRGM' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/toolcodes/terms?short_name=MWD%252BSRGM HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: fe2193df25d6c356024f3209ecb2e36e
Content-Type: text/plain;charset=UTF-8

drfr    e   r   m   0.35    1.0
dsfs    e   s   -   0.00056 tmd
dstg    e   g   im  2.5e-007    tmd*tvd
xym1    i   s   d   0.1 abs(sin(inc))
xym2    a   s   d   0.1 -1.0
xym3e   i   r   d   0.3 cos(inc)*cos(azi)*max(1,sqrt(10/smd))
xym3e   a   r   d   0.3 -(cos(inc)*sin(azi)/sin(inc))*max(1,sqrt(10/smd))
xym4e   i   r   d   0.3 cos(inc)*sin(azi)*max(1,sqrt(10/smd))
xym4e   a   r   d   0.3 (cos(inc)*cos(azi)/sin(inc))*max(1,sqrt(10/smd))
sage    i   s   d   0.2 (sin(inc))^0.25
decu    a   w   d   0.16    1.0
decos   a   g   d   0.24    1.0
decoh   a   g   d   0.21    1.0
decoi   a   g   d   0.05    1.0
decr    a   r   d   0.1 1.0
dbhu    a   w   dnt 2350    1.0/(mtot*cos(dip))
dbhos   a   g   dnt 3359    1.0/(mtot*cos(dip))
dbhoh   a   g   dnt 2840    1.0/(mtot*cos(dip))
dbhoi   a   g   dnt 356 1.0/(mtot*cos(dip))
dbhr    a   r   dnt 3000    1.0/(mtot*cos(dip))
amil    a   s   nt  220 sin(inc)*sin(azm)/(mtot*cos(dip))
abxy_ti1    i   s   -   0.004   (-cos(inc))/gtot
abxy_ti1    a   s   -   0.004   (tan(dip)*cos(inc)*sin(azm))/gtot
abxy_ti2    a   s   -   0.004   ((tan((pi()/2)-inc))-tan(dip)*cos(azm))/gtot
abz i   s   -   0.004   (-sin(inc))/gtot
abz a   s   -   0.004   (tan(dip)*sin(inc)*sin(azm))/gtot
asxy_ti1    i   s   -   0.0005  (sin(inc)*cos(inc))/(2^0.5)
asxy_ti1    a   s   -   0.0005  (-(tan(dip)*sin(inc)*cos(inc)*sin(azm)))/(2^0.5)
asxy_ti2    i   s   -   0.0005  (sin(inc)*cos(inc))/2
asxy_ti2    a   s   -   0.0005  (-(tan(dip)*sin(inc)*cos(inc)*sin(azm)))/2
asxy_ti3    a   s   -   0.0005  (tan(dip)*sin(inc)*cos(azm)-cos(inc))/2
asz i   s   -   0.0005  (-sin(inc)*cos(inc))
asz a   s   -   0.0005  (tan(dip)*sin(inc)*cos(inc)*sin(azm))
mbxy_ti1    a   s   nt  70  (-(cos(inc)*sin(azm)))/(mtot*cos(dip))
mbxy_ti2    a   s   nt  70  (cos(azm))/(mtot*cos(dip))
mbz a   s   nt  70  (-sin(inc)*sin(azm))/(mtot*cos(dip))
msxy_ti1    a   s   -   0.0016  (sin(inc)*sin(azm)*(tan(dip)*cos(inc)+sin(inc)*cos(azm)))/(2^0.5)
msxy_ti2    a   s   -   0.0016  (sin(azm)*(tan(dip)*sin(inc)*cos(inc)-(cos(inc))^2*cos(azm)-cos(azm)))/2
msxy_ti3    a   s   -   0.0016  (cos(inc)*(cos(azm))^2-cos(inc)*(sin(azm))^2-tan(dip)*sin(inc)*cos(azm))/2
msz a   s   -   0.0016  (-(sin(inc)*cos(azm)+tan(dip)*cos(inc))*sin(inc)*sin(azm))
xcla    a   r   -   0.167   max(sin(abs(daz)),0.00018*smd/sin(inc))
xclh    i   r   -   0.167   max(abs(dic),0.00018*smd)

GET /public/api/v1/toolcodes/terms

Parameter Description
short_name Short name of a built-in or custom toolcode, encode + as %2B
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Create or update toolcode

Create a custom toolcode of the user's company from a toolcode file, or completely replace the custom toolcode with the same ShortName (fields missing in the file are cleared). A built-in toolcode cannot be replaced, 400 is returned. Returns the saved toolcode

Request

$ curl 'https://solo.cloud/public/api/v1/toolcodes' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: multipart/form-data' \
    -F 'data=@toolcode_with_all_fields.txt;type=application/octet-stream'

PUT /public/api/v1/toolcodes HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Host: solo.cloud

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=data; filename=toolcode_with_all_fields.txt
Content-Type: application/octet-stream

#ShortName:TEST_TOOLCODE
#Prefix:A002Mc
#Description:A002Mb/ISC4: BGGM dec + sag corrections
#ToolCategory:Magnetic
#ToolType:MWD
#RigType:Fixed
#SagCorrection:SAG
#MagneticCorrection:AX
#GeomagneticReference:SRGM
#Revision:ISCWSA Rev5.1
#RevisionDate:23/09/2022
#Name   Vector  Tie-On  Unit    Value   Formula
drfr    e   r   m   0.35    1.0
dsfs    e   s   -   0.00056 tmd
dstg    e   g   im  2.5e-007    tmd*tvd
xym1    i   s   d   0.1 abs(sin(inc))
xym2    a   s   d   0.1 -1.0
xym3e   i   r   d   0.3 cos(inc)*cos(azi)*max(1,sqrt(10/smd))
xym3e   a   r   d   0.3 -(cos(inc)*sin(azi)/sin(inc))*max(1,sqrt(10/smd))
xym4e   i   r   d   0.3 cos(inc)*sin(azi)*max(1,sqrt(10/smd))
xym4e   a   r   d   0.3 (cos(inc)*cos(azi)/sin(inc))*max(1,sqrt(10/smd))
sage    i   s   d   0.08    (sin(inc))^0.25
decu    a   w   d   0.16    1.0
decos   a   g   d   0.24    1.0
decoh   a   g   d   0.21    1.0
decoi   a   g   d   0.05    1.0
decr    a   r   d   0.1 1.0
dbhu    a   w   dnt 2350    1.0/(mtot*cos(dip))
dbhos   a   g   dnt 3359    1.0/(mtot*cos(dip))
dbhoh   a   g   dnt 2840    1.0/(mtot*cos(dip))
dbhoi   a   g   dnt 356 1.0/(mtot*cos(dip))
dbhr    a   r   dnt 3000    1.0/(mtot*cos(dip))
amil    a   s   nt  220 sin(inc)*sin(azm)/(mtot*cos(dip))
abxy_ti1    i   s   -   0.004   (-cos(inc))/gtot
abxy_ti1    a   s   -   0.004   (tan(dip)*cos(inc)*sin(azm))/gtot
abxy_ti2    a   s   -   0.004   ((tan((pi()/2)-inc))-tan(dip)*cos(azm))/gtot
abz i   s   -   0.004   (-sin(inc))/gtot
abz a   s   -   0.004   (tan(dip)*sin(inc)*sin(azm))/gtot
asxy_ti1    i   s   -   0.0005  (sin(inc)*cos(inc))/(2^0.5)
asxy_ti1    a   s   -   0.0005  (-(tan(dip)*sin(inc)*cos(inc)*sin(azm)))/(2^0.5)
asxy_ti2    i   s   -   0.0005  (sin(inc)*cos(inc))/2
asxy_ti2    a   s   -   0.0005  (-(tan(dip)*sin(inc)*cos(inc)*sin(azm)))/2
asxy_ti3    a   s   -   0.0005  (tan(dip)*sin(inc)*cos(azm)-cos(inc))/2
asz i   s   -   0.0005  (-sin(inc)*cos(inc))
asz a   s   -   0.0005  (tan(dip)*sin(inc)*cos(inc)*sin(azm))
mbxy_ti1    a   s   nt  70  (-(cos(inc)*sin(azm)))/(mtot*cos(dip))
mbxy_ti2    a   s   nt  70  (cos(azm))/(mtot*cos(dip))
mbz a   s   nt  70  (-sin(inc)*sin(azm))/(mtot*cos(dip))
msxy_ti1    a   s   -   0.0016  (sin(inc)*sin(azm)*(tan(dip)*cos(inc)+sin(inc)*cos(azm)))/(2^0.5)
msxy_ti2    a   s   -   0.0016  (sin(azm)*(tan(dip)*sin(inc)*cos(inc)-(cos(inc))^2*cos(azm)-cos(azm)))/2
msxy_ti3    a   s   -   0.0016  (cos(inc)*(cos(azm))^2-cos(inc)*(sin(azm))^2-tan(dip)*sin(inc)*cos(azm))/2
msz a   s   -   0.0016  (-(sin(inc)*cos(azm)+tan(dip)*cos(inc))*sin(inc)*sin(azm))
xcla    a   r   -   0.167   max(sin(abs(daz)),0.00018*smd/sin(inc))
xclh    i   r   -   0.167   max(abs(dic),0.00018*smd)
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e5e8f7fa203168b37f9fcda75c2007c2
Content-Type: application/json

{
  "short_name" : "TEST_TOOLCODE",
  "description" : "A002Mb/ISC4: BGGM dec + sag corrections",
  "prefix" : "A002Mc",
  "tool_category" : "Magnetic",
  "tool_type" : "MWD",
  "rig_type" : "Fixed",
  "sag_correction" : "SAG",
  "magnetic_correction" : "AX",
  "geomagnetic_reference" : "SRGM",
  "revision" : "ISCWSA Rev5.1",
  "revision_date" : "2022-09-23",
  "custom" : true
}

PUT /public/api/v1/toolcodes

Part Description
data Toolcode file: #Key:Value header lines (ShortName and Description are required, optional Prefix, ToolCategory, ToolType, RigType, SagCorrection, MagneticCorrection, GeomagneticReference, Revision, RevisionDate as dd/MM/yyyy) followed by the error model terms, up to 10000 characters
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
short_name String Toolcode short name
description String Description
prefix String Prefix
tool_category String Tool category
tool_type String Tool type
rig_type String Rig type
sag_correction String Sag correction
magnetic_correction String Magnetic correction
geomagnetic_reference String Geomagnetic reference
revision String Revision
revision_date String Revision date, yyyy-MM-dd
custom Boolean true for a custom toolcode of the user's company, false for a built-in toolcode

Delete toolcode

Delete a custom toolcode of the user's company by short name. A built-in toolcode cannot be deleted, 400 is returned. Deleting a missing toolcode also returns 204

Request

$ curl 'https://solo.cloud/public/api/v1/toolcodes?short_name=TEST_TOOLCODE' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>'

DELETE /public/api/v1/toolcodes?short_name=TEST_TOOLCODE HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 204 No Content
X-Solo-Trace-Id: 88e65c4d16d0378a86f3ef28b7815b42

DELETE /public/api/v1/toolcodes

Parameter Description
short_name Short name of a custom toolcode of the user's company, encode + as %2B
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

25. Trajectories

Get lateral trajectory

Get lateral trajectory data by lateral UUID

Request

$ curl 'https://solo.cloud/public/api/v1/wells/8d9f3929-f736-46d7-94ae-6aaeea69b627/trajectory' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/8d9f3929-f736-46d7-94ae-6aaeea69b627/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 8e7f71d247c1213b50184c8082d1ecb0
Content-Type: application/json

{
  "content" : [ {
    "md" : {
      "val" : 0.0
    },
    "incl" : {
      "val" : 0.0
    },
    "azim" : {
      "val" : 0.0
    }
  }, {
    "md" : {
      "val" : 3280.839895013124
    },
    "incl" : {
      "val" : 0.4583662361046284
    },
    "azim" : {
      "val" : 0.0
    }
  }, {
    "md" : {
      "val" : 4921.259842519686
    },
    "incl" : {
      "val" : 84.79775367935625
    },
    "azim" : {
      "val" : 9.740282517223354
    }
  }, {
    "md" : {
      "val" : 13123.359580052496
    },
    "incl" : {
      "val" : 89.95437383553333
    },
    "azim" : {
      "val" : 9.740282517223354
    }
  } ]
}

GET /public/api/v1/wells/{uuid}/trajectory

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Trajectory points array
content[].md.val Number Measured Depth value in project units
content[].incl.val Number Inclination value (degrees)
content[].azim.val Number Azimuth value (degrees)

Extend lateral trajectory

Extend lateral trajectory with the sent stations. Sent stations shallower than the first existing station are ignored, as are stations with an undefined incl or azi. Existing stations from the first to the last remaining sent station (by MD) are replaced by them, stations outside that range are kept. md_uom, incl_uom and azi_uom are required, the stations array must not be empty, every station must have md, incl and azi (azim can be used instead of azi, if both are sent azim is used). Returns 403 if the lateral is locked or is a private lateral of another user

Request

$ curl 'https://solo.cloud/public/api/v1/wells/963b7f11-f3d7-485c-8f6d-0f25a50b080f/trajectory' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}'

PATCH /public/api/v1/wells/963b7f11-f3d7-485c-8f6d-0f25a50b080f/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 344

{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 63aff19f41ef26d0b963f7e297adc9b7

PATCH /public/api/v1/wells/{uuid}/trajectory

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
md_uom String Required. Measure unit of the station md values. Accepted values (case-sensitive): m, ft, ftUS, mm, inchUS
incl_uom String Required. Measure unit of the station incl values. Accepted values (case-sensitive): dega (degrees), rad (radians)
azi_uom String Required. Measure unit of the station azi values. Accepted values (case-sensitive): dega (degrees), rad (radians)
trajectory_stations Array Lateral trajectory stations array, must not be empty
trajectory_stations[].md.val Number Station measured depth in md_uom units, required
trajectory_stations[].incl.val Number Station inclination in incl_uom units, required
trajectory_stations[].azi.val Number Station azimuth in azi_uom units, required. azim is accepted instead of azi, if both are sent azim is used

Response body

Empty body

Replace lateral trajectory

Replace lateral trajectory with the sent stations. md_uom, incl_uom and azi_uom are required, the stations array must not be empty, every station must have md, incl and azi (azim can be used instead of azi, if both are sent azim is used). Returns 403 if the lateral is locked or is a private lateral of another user

Request

$ curl 'https://solo.cloud/public/api/v1/wells/963b7f11-f3d7-485c-8f6d-0f25a50b080f/trajectory' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}'

PUT /public/api/v1/wells/963b7f11-f3d7-485c-8f6d-0f25a50b080f/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 344

{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: b6d5a36b4d786f9adb6629bcab5f8c91

PUT /public/api/v1/wells/{uuid}/trajectory

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
md_uom String Required. Measure unit of the station md values. Accepted values (case-sensitive): m, ft, ftUS, mm, inchUS
incl_uom String Required. Measure unit of the station incl values. Accepted values (case-sensitive): dega (degrees), rad (radians)
azi_uom String Required. Measure unit of the station azi values. Accepted values (case-sensitive): dega (degrees), rad (radians)
trajectory_stations Array Lateral trajectory stations array, must not be empty
trajectory_stations[].md.val Number Station measured depth in md_uom units, required
trajectory_stations[].incl.val Number Station inclination in incl_uom units, required
trajectory_stations[].azi.val Number Station azimuth in azi_uom units, required. azim is accepted instead of azi, if both are sent azim is used

Response body

Empty body

Get typewell trajectory

Get typewell trajectory data by typewell UUID

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/4e6c6daf-84d8-41fa-b552-dff10da22b85/trajectory' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/4e6c6daf-84d8-41fa-b552-dff10da22b85/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 57d6fe42b7430006826b91622ea5deb9
Content-Type: application/json

{
  "content" : [ {
    "md" : {
      "val" : 0.0
    },
    "incl" : {
      "val" : 0.0
    },
    "azim" : {
      "val" : 0.0
    }
  }, {
    "md" : {
      "val" : 3280.839895013124
    },
    "incl" : {
      "val" : 0.4583662361046284
    },
    "azim" : {
      "val" : 0.0
    }
  }, {
    "md" : {
      "val" : 4921.259842519686
    },
    "incl" : {
      "val" : 84.79775367935625
    },
    "azim" : {
      "val" : 9.740282517223354
    }
  }, {
    "md" : {
      "val" : 13123.359580052496
    },
    "incl" : {
      "val" : 89.95437383553333
    },
    "azim" : {
      "val" : 9.740282517223354
    }
  } ]
}

GET /public/api/v1/typewells/{uuid}/trajectory

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Trajectory points array
content[].md.val Number Measured Depth value in project units
content[].incl.val Number Inclination value (degrees)
content[].azim.val Number Azimuth value (degrees)

Extend typewell trajectory

Extend typewell trajectory with the sent stations. Sent stations shallower than the first existing station are ignored, as are stations with an undefined incl or azi. Existing stations from the first to the last remaining sent station (by MD) are replaced by them, stations outside that range are kept. md_uom, incl_uom and azi_uom are required, the stations array must not be empty, every station must have md, incl and azi (azim can be used instead of azi, if both are sent azim is used). Returns 403 if the typewell is locked or is a private typewell of another user

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/72269dac-3165-4910-9f45-90d4a75e4930/trajectory' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}'

PATCH /public/api/v1/typewells/72269dac-3165-4910-9f45-90d4a75e4930/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 344

{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 69550f45a9e45f4c602f28cb44ccb343

PATCH /public/api/v1/typewells/{uuid}/trajectory

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
md_uom String Required. Measure unit of the station md values. Accepted values (case-sensitive): m, ft, ftUS, mm, inchUS
incl_uom String Required. Measure unit of the station incl values. Accepted values (case-sensitive): dega (degrees), rad (radians)
azi_uom String Required. Measure unit of the station azi values. Accepted values (case-sensitive): dega (degrees), rad (radians)
trajectory_stations Array Typewell trajectory stations array, must not be empty
trajectory_stations[].md.val Number Station measured depth in md_uom units, required
trajectory_stations[].incl.val Number Station inclination in incl_uom units, required
trajectory_stations[].azi.val Number Station azimuth in azi_uom units, required. azim is accepted instead of azi, if both are sent azim is used

Response body

Empty body

Replace typewell trajectory

Replace typewell trajectory with the sent stations. md_uom, incl_uom and azi_uom are required, the stations array must not be empty, every station must have md, incl and azi (azim can be used instead of azi, if both are sent azim is used). Returns 403 if the typewell is locked or is a private typewell of another user

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/72269dac-3165-4910-9f45-90d4a75e4930/trajectory' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}'

PUT /public/api/v1/typewells/72269dac-3165-4910-9f45-90d4a75e4930/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 344

{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 330bd6aee1dc281bf79e031c02405592

PUT /public/api/v1/typewells/{uuid}/trajectory

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
md_uom String Required. Measure unit of the station md values. Accepted values (case-sensitive): m, ft, ftUS, mm, inchUS
incl_uom String Required. Measure unit of the station incl values. Accepted values (case-sensitive): dega (degrees), rad (radians)
azi_uom String Required. Measure unit of the station azi values. Accepted values (case-sensitive): dega (degrees), rad (radians)
trajectory_stations Array Typewell trajectory stations array, must not be empty
trajectory_stations[].md.val Number Station measured depth in md_uom units, required
trajectory_stations[].incl.val Number Station inclination in incl_uom units, required
trajectory_stations[].azi.val Number Station azimuth in azi_uom units, required. azim is accepted instead of azi, if both are sent azim is used

Response body

Empty body

Get nested well trajectory

Get nested well trajectory data by nested well UUID

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/bf89e67b-a18b-4b9d-9d7c-5ad0b9683943/trajectory' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/nestedwells/bf89e67b-a18b-4b9d-9d7c-5ad0b9683943/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: a2e06b2cde367888d0c75b8f27d1fa66
Content-Type: application/json

{
  "content" : [ {
    "md" : {
      "val" : 0.0
    },
    "incl" : {
      "val" : 0.0
    },
    "azim" : {
      "val" : 0.0
    }
  }, {
    "md" : {
      "val" : 3280.839895013124
    },
    "incl" : {
      "val" : 0.4583662361046284
    },
    "azim" : {
      "val" : 0.0
    }
  }, {
    "md" : {
      "val" : 4921.259842519686
    },
    "incl" : {
      "val" : 84.79775367935625
    },
    "azim" : {
      "val" : 9.740282517223354
    }
  }, {
    "md" : {
      "val" : 13123.359580052496
    },
    "incl" : {
      "val" : 89.95437383553333
    },
    "azim" : {
      "val" : 9.740282517223354
    }
  } ]
}

GET /public/api/v1/nestedwells/{uuid}/trajectory

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Trajectory points array
content[].md.val Number Measured Depth value in project units
content[].incl.val Number Inclination value (degrees)
content[].azim.val Number Azimuth value (degrees)

Extend nested well trajectory

Extend nested well trajectory with the sent stations. Sent stations shallower than the first existing station are ignored, as are stations with an undefined incl or azi. Existing stations from the first to the last remaining sent station (by MD) are replaced by them, stations outside that range are kept. md_uom, incl_uom and azi_uom are required, the stations array must not be empty, every station must have md, incl and azi (azim can be used instead of azi, if both are sent azim is used). Returns 403 if the nested well is locked or is a private nested well of another user

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/2db15af0-64e6-4aa9-b19a-7b943771cbff/trajectory' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}'

PATCH /public/api/v1/nestedwells/2db15af0-64e6-4aa9-b19a-7b943771cbff/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 344

{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 40ba21b684960a8c4cef46c813504abe

PATCH /public/api/v1/nestedwells/{uuid}/trajectory

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
md_uom String Required. Measure unit of the station md values. Accepted values (case-sensitive): m, ft, ftUS, mm, inchUS
incl_uom String Required. Measure unit of the station incl values. Accepted values (case-sensitive): dega (degrees), rad (radians)
azi_uom String Required. Measure unit of the station azi values. Accepted values (case-sensitive): dega (degrees), rad (radians)
trajectory_stations Array Nested well trajectory stations array, must not be empty
trajectory_stations[].md.val Number Station measured depth in md_uom units, required
trajectory_stations[].incl.val Number Station inclination in incl_uom units, required
trajectory_stations[].azi.val Number Station azimuth in azi_uom units, required. azim is accepted instead of azi, if both are sent azim is used

Response body

Empty body

Replace nested well trajectory

Replace nested well trajectory with the sent stations. md_uom, incl_uom and azi_uom are required, the stations array must not be empty, every station must have md, incl and azi (azim can be used instead of azi, if both are sent azim is used). Returns 403 if the nested well is locked or is a private nested well of another user

Request

$ curl 'https://solo.cloud/public/api/v1/nestedwells/8cb081ee-be4c-4293-a331-b7748cad368d/trajectory' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}'

PUT /public/api/v1/nestedwells/8cb081ee-be4c-4293-a331-b7748cad368d/trajectory HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 344

{
  "md_uom" : "m",
  "incl_uom" : "dega",
  "azi_uom" : "rad",
  "trajectory_stations" : [ {
    "md" : {
      "val" : 1389
    },
    "incl" : {
      "val" : 1.1
    },
    "azi" : {
      "val" : 1.63
    }
  }, {
    "md" : {
      "val" : 1489
    },
    "incl" : {
      "val" : 2.1
    },
    "azi" : {
      "val" : 1.43
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 17b136651901643e4b50a4305d9946a6

PUT /public/api/v1/nestedwells/{uuid}/trajectory

Path parameter Description
uuid Nested well UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
md_uom String Required. Measure unit of the station md values. Accepted values (case-sensitive): m, ft, ftUS, mm, inchUS
incl_uom String Required. Measure unit of the station incl values. Accepted values (case-sensitive): dega (degrees), rad (radians)
azi_uom String Required. Measure unit of the station azi values. Accepted values (case-sensitive): dega (degrees), rad (radians)
trajectory_stations Array Nested well trajectory stations array, must not be empty
trajectory_stations[].md.val Number Station measured depth in md_uom units, required
trajectory_stations[].incl.val Number Station inclination in incl_uom units, required
trajectory_stations[].azi.val Number Station azimuth in azi_uom units, required. azim is accepted instead of azi, if both are sent azim is used

Response body

Empty body

Get multiple trajectories

Get multiple trajectories by their UUIDs. At most 100 distinct UUIDs can be requested in total, otherwise 400 is returned. UUIDs that are not found, not accessible or listed under a wrong type are skipped (even if also listed under the right one), a UUID listed twice in the same array is returned once, the order of the result is not guaranteed

Request

$ curl 'https://solo.cloud/public/api/v1/trajectories' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "wells" : [ "8d9f3929-f736-46d7-94ae-6aaeea69b627", "7a2582eb-429a-45e0-a429-071f13d545a9" ],
  "typewells" : [ "4e6c6daf-84d8-41fa-b552-dff10da22b85" ],
  "nestedwells" : [ "bf89e67b-a18b-4b9d-9d7c-5ad0b9683943" ]
}'

POST /public/api/v1/trajectories HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 220

{
  "wells" : [ "8d9f3929-f736-46d7-94ae-6aaeea69b627", "7a2582eb-429a-45e0-a429-071f13d545a9" ],
  "typewells" : [ "4e6c6daf-84d8-41fa-b552-dff10da22b85" ],
  "nestedwells" : [ "bf89e67b-a18b-4b9d-9d7c-5ad0b9683943" ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 5522a4b0a5933495b9f950c93016f131
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "bf89e67b-a18b-4b9d-9d7c-5ad0b9683943",
    "trajectory" : [ {
      "md" : {
        "val" : 0.0
      },
      "incl" : {
        "val" : 0.0
      },
      "azim" : {
        "val" : 0.0
      }
    }, {
      "md" : {
        "val" : 3280.839895013124
      },
      "incl" : {
        "val" : 0.4583662361046284
      },
      "azim" : {
        "val" : 0.0
      }
    }, {
      "md" : {
        "val" : 4921.259842519686
      },
      "incl" : {
        "val" : 84.79775367935625
      },
      "azim" : {
        "val" : 9.740282517223354
      }
    }, {
      "md" : {
        "val" : 13123.359580052496
      },
      "incl" : {
        "val" : 89.95437383553333
      },
      "azim" : {
        "val" : 9.740282517223354
      }
    } ]
  }, {
    "uuid" : "4e6c6daf-84d8-41fa-b552-dff10da22b85",
    "trajectory" : [ {
      "md" : {
        "val" : 0.0
      },
      "incl" : {
        "val" : 0.0
      },
      "azim" : {
        "val" : 0.0
      }
    }, {
      "md" : {
        "val" : 3280.839895013124
      },
      "incl" : {
        "val" : 0.4583662361046284
      },
      "azim" : {
        "val" : 0.0
      }
    }, {
      "md" : {
        "val" : 4921.259842519686
      },
      "incl" : {
        "val" : 84.79775367935625
      },
      "azim" : {
        "val" : 9.740282517223354
      }
    }, {
      "md" : {
        "val" : 13123.359580052496
      },
      "incl" : {
        "val" : 89.95437383553333
      },
      "azim" : {
        "val" : 9.740282517223354
      }
    } ]
  }, {
    "uuid" : "8d9f3929-f736-46d7-94ae-6aaeea69b627",
    "trajectory" : [ {
      "md" : {
        "val" : 0.0
      },
      "incl" : {
        "val" : 0.0
      },
      "azim" : {
        "val" : 0.0
      }
    }, {
      "md" : {
        "val" : 3280.839895013124
      },
      "incl" : {
        "val" : 0.4583662361046284
      },
      "azim" : {
        "val" : 0.0
      }
    }, {
      "md" : {
        "val" : 4921.259842519686
      },
      "incl" : {
        "val" : 84.79775367935625
      },
      "azim" : {
        "val" : 9.740282517223354
      }
    }, {
      "md" : {
        "val" : 13123.359580052496
      },
      "incl" : {
        "val" : 89.95437383553333
      },
      "azim" : {
        "val" : 9.740282517223354
      }
    } ]
  }, {
    "uuid" : "7a2582eb-429a-45e0-a429-071f13d545a9",
    "trajectory" : [ {
      "md" : {
        "val" : 0.0
      },
      "incl" : {
        "val" : 0.0
      },
      "azim" : {
        "val" : 71.54300000000002
      }
    }, {
      "md" : {
        "val" : 61.19866000000002
      },
      "incl" : {
        "val" : 0.35
      },
      "azim" : {
        "val" : 176.083
      }
    }, {
      "md" : {
        "val" : 100.42002000000001
      },
      "incl" : {
        "val" : 0.25
      },
      "azim" : {
        "val" : 259.043
      }
    }, {
      "md" : {
        "val" : 124.93996000000003
      },
      "incl" : {
        "val" : 0.28
      },
      "azim" : {
        "val" : 227.59299999999993
      }
    }, {
      "md" : {
        "val" : 174.66991
      },
      "incl" : {
        "val" : 1.13
      },
      "azim" : {
        "val" : 154.423
      }
    }, {
      "md" : {
        "val" : 201.38989
      },
      "incl" : {
        "val" : 1.26
      },
      "azim" : {
        "val" : 140.38299999999998
      }
    }, {
      "md" : {
        "val" : 225.35998000000004
      },
      "incl" : {
        "val" : 1.2999999999999998
      },
      "azim" : {
        "val" : 153.71299999999997
      }
    }, {
      "md" : {
        "val" : 3280.839895013124
      },
      "incl" : {
        "val" : 1.33
      },
      "azim" : {
        "val" : 149.25300000000001
      }
    } ]
  } ]
}

POST /public/api/v1/trajectories

Header Description
Authorization OAuth2 authorization header
Body field Type Description
wells Array Lateral UUIDs to download trajectories for
typewells Array Typewell UUIDs to download trajectories for
nestedwells Array Nested well UUIDs to download trajectories for

Response body

Path Type Description
content Array List of trajectories, one per found and accessible object, in no particular order
content[].uuid String Lateral, typewell or nested well UUID
content[].trajectory Array Trajectory points of the lateral, typewell or nested well
content[].trajectory[].md.val Number Measured depth value in project units
content[].trajectory[].incl.val Number Inclination value (degrees)
content[].trajectory[].azim.val Number Azimuth value (degrees)

26. Public data

Get nearby wells

Search wells of the Solo public data projects whose surface location is within radius_miles of the given point. The point is given, and the well latitude and longitude are returned, in degrees in the geographic CRS set by epsg_mnemonic or epsg_crs_code. The response is not paged, at most 50000 wells are returned. KB elevation is returned in the units of the well's project (measure_unit). Returns 406 if neither or both of epsg_mnemonic and epsg_crs_code are set or radius_miles is greater than 100 (a server setting), and 400 if a value is out of range or the CRS cannot be transformed

Request

$ curl 'https://solo.cloud/public/api/v1/publicdata/nearbywells' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "epsg_mnemonic" : "NAD83",
  "latitude" : 30.9807,
  "longitude" : -115.9835,
  "radius_miles" : 5.0
}'

POST /public/api/v1/publicdata/nearbywells HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 106

{
  "epsg_mnemonic" : "NAD83",
  "latitude" : 30.9807,
  "longitude" : -115.9835,
  "radius_miles" : 5.0
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 77321773cd753474b52c825ef5022501
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "453fb568-8e36-4511-bd9d-2b01ca63ea54",
    "name" : "Lateral",
    "api" : "string",
    "operator" : "string",
    "latitude" : 30.9807176184,
    "longitude" : -115.9834603823,
    "latitude_wgs84" : 30.9807176184,
    "longitude_wgs84" : -115.9834603823,
    "project_uuid" : "97f8f774-ea30-4fa1-b4b7-c6c81b0872ee",
    "measure_unit" : "FOOT",
    "elevation" : {
      "val" : 22.96587926509186
    },
    "tvd" : {
      "val" : 10000.0
    },
    "convergence" : {
      "val" : 0.0
    },
    "is_true_north_azimuth" : false,
    "state" : "Baja California",
    "county" : "Mexico",
    "type" : "WELL"
  } ]
}

POST /public/api/v1/publicdata/nearbywells

Header Description
Authorization OAuth2 authorization header
Body field Type Description
epsg_mnemonic String EPSG mnemonic: NAD27 (EPSG:4267) or NAD83 (EPSG:4269). Exactly one of 'epsg_mnemonic' and 'epsg_crs_code' must be set
epsg_crs_code Number EPSG code of a geographic CRS (degrees) in which the search center is given and the well latitude and longitude are returned
latitude Number Latitude of the search center in degrees in the request CRS, range [-90; 90]
longitude Number Longitude of the search center in degrees in the request CRS, range [-180; 180]
radius_miles Number Search radius in miles, greater than 0 and not greater than 100

Response body

Path Type Description
content Array Wells of the Solo public data projects whose surface location is within the radius. The list is not paged, at most 50000 wells are returned
content[].uuid String Well UUID
content[].name String Well name
content[].api String Well API number
content[].operator String Well operator
content[].latitude Number Well surface latitude in degrees in the request CRS
content[].longitude Number Well surface longitude in degrees in the request CRS
content[].latitude_wgs84 Number Well surface latitude in WGS84 (degrees)
content[].longitude_wgs84 Number Well surface longitude in WGS84 (degrees)
content[].project_uuid String UUID of the public data project of the well
content[].measure_unit String Project measure unit: FOOT, METER or METER_FOOT
content[].elevation.val Number Well KB elevation (project units)
content[].tvd.val Number Well final TVD value (project units)
content[].convergence.val Number Well convergence angle in degrees, range [-180; 180)
content[].is_true_north_azimuth Boolean true if the well convergence is set and non-zero, otherwise false
content[].state String State or province of the well surface location, absent if not determined
content[].county String Country (not county) of the well surface location, absent if not determined
content[].type String Well type: WELL, TYPEWELL or NESTEDWELL

27. Image logs

Create image log by lateral

Create an empty image log by lateral UUID. The image log is not listed by Get image logs by lateral until its data is uploaded

Request

$ curl 'https://solo.cloud/public/api/v1/wells/c4036f0f-e942-4572-98d5-ea91f6bf5007/imagelogs' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Image log name"
}'

POST /public/api/v1/wells/c4036f0f-e942-4572-98d5-ea91f6bf5007/imagelogs HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 31

{
  "name" : "Image log name"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 18f7143fe8f31a88f8eaa9f21b8396ca
Content-Type: application/json

{
  "uuid" : "4a4f7c9f-8f96-407a-ac78-54dca22b4327"
}

POST /public/api/v1/wells/{uuid}/imagelogs

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Image log name, up to 200 characters

Response body

Path Type Description
uuid String Created image log UUID

Get image logs by lateral

Get a list of image logs by lateral UUID with pagination, in creation order. Image logs that do not contain data will not be included in the response

Request

$ curl 'https://solo.cloud/public/api/v1/wells/5bb5217b-aeef-4f79-abe3-1f72d552cc38/imagelogs?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/5bb5217b-aeef-4f79-abe3-1f72d552cc38/imagelogs?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 611350173169fe522e13258a781b12ac
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "518e52d7-5f15-4c14-a7e2-5d4ba7e20574",
    "name" : "Acoustic Image"
  }, {
    "uuid" : "9befdfc6-c830-4823-8488-ae08b18e22df",
    "name" : "Resistivity Image",
    "is_data_content_outdated" : false,
    "data_content" : [ {
      "order_index" : 0,
      "log_uid" : "RES_UID0",
      "log_name" : "RES_NAME0",
      "sector" : "Up",
      "unit" : "OHMM"
    }, {
      "order_index" : 1,
      "log_uid" : "RES_UID1",
      "log_name" : "RES_NAME1",
      "sector" : "Down",
      "unit" : "OHMM"
    } ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/imagelogs

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Image log UUID
content[].name String Image log name
content[].is_data_content_outdated Boolean true if data_content was recorded for an older version of the image log data than the current one. Absent if there is no data_content
content[].data_content Array Source logs the image log was assembled from by real-time streaming, taken from the latest data version that has them. Absent if the image log has no such data
content[].data_content[].order_index Number Order index of the log inside image log data content
content[].data_content[].log_uid String UID of the log used as a source for image log data content
content[].data_content[].log_name String Name of the log used as a source for image log data content
content[].data_content[].sector String Sector of the log used as a source for image log data content
content[].data_content[].unit String Unit of the log used as a source for image log data content

Get image log data

Get image log data by UUID. MD values are returned in project depth units. Returns 404 if the image log has no data

Request

$ curl 'https://solo.cloud/public/api/v1/imagelogs/96864bbe-90cf-4227-a620-e69cf9ad84ec/data' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/imagelogs/96864bbe-90cf-4227-a620-e69cf9ad84ec/data HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 00800f3ed629ad135a6a66887d3463ef
Content-Type: application/json

{
  "log_points" : [ {
    "channels" : [ {
      "data" : [ {
        "val" : -83.6675
      }, {
        "val" : 61.808
      }, {
        "val" : 61.808
      }, {
        "val" : 61.808
      }, {
        "val" : 68.125
      }, {
        "val" : 68.125
      }, {
        "val" : 75.144
      }, {
        "val" : 75.144
      }, {
        "val" : 73.038
      }, {
        "val" : 65.318
      } ],
      "description" : "",
      "mnemonic" : ""
    }, {
      "data" : [ {
        "val" : -83.6675
      }, {
        "val" : 61.808
      }, {
        "val" : 61.808
      }, {
        "val" : 61.808
      }, {
        "val" : 68.125
      }, {
        "val" : 68.125
      }, {
        "val" : 75.144
      }, {
        "val" : 75.144
      }, {
        "val" : 73.038
      }, {
        "val" : 65.318
      } ],
      "description" : "",
      "mnemonic" : ""
    }, {
      "data" : [ {
        "val" : -83.6675
      }, {
        "val" : 61.808
      }, {
        "val" : 61.808
      }, {
        "val" : 61.808
      }, {
        "val" : 68.125
      }, {
        "val" : 68.125
      }, {
        "val" : 75.144
      }, {
        "val" : 75.144
      }, {
        "val" : 73.038
      }, {
        "val" : 65.318
      } ],
      "description" : "",
      "mnemonic" : ""
    }, {
      "data" : [ {
        "val" : -83.6675
      }, {
        "val" : 61.808
      }, {
        "val" : 61.808
      }, {
        "val" : 61.808
      }, {
        "val" : 68.125
      }, {
        "val" : 68.125
      }, {
        "val" : 75.144
      }, {
        "val" : 75.144
      }, {
        "val" : 73.038
      }, {
        "val" : 65.318
      } ],
      "description" : "",
      "mnemonic" : ""
    } ],
    "md" : [ {
      "val" : 2478.4999999999995
    }, {
      "val" : 2480.4999999999995
    }, {
      "val" : 2480.9999999999995
    }, {
      "val" : 2481.4999999999995
    }, {
      "val" : 2481.9999999999995
    }, {
      "val" : 2482.4999999999995
    }, {
      "val" : 2482.9999999999995
    }, {
      "val" : 2483.4999999999995
    }, {
      "val" : 2483.9999999999995
    }, {
      "val" : 2484.4999999999995
    } ]
  } ]
}

GET /public/api/v1/imagelogs/{uuid}/data

Path parameter Description
uuid Image log UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
log_points Array Image log points array
log_points[].md Array Measured depth values array
log_points[].md[].val Number Measured depth value in project depth units
log_points[].channels Array Image log point data channels array
log_points[].channels[].mnemonic String Data channel mnemonic
log_points[].channels[].description String Data channel description
log_points[].channels[].data Array Data channel values array
log_points[].channels[].data[].val Number Data value, absent if the value is undefined
log_points[].channels[].data[].undefined Boolean true if the data value is undefined

Upload\replace image log data

Upload image log data by UUID, replacing the existing data. log_points must contain exactly one element with the md array and at least one channel. MD values are in project depth units, they must be defined and non-decreasing, every channel data array must have the same length as md. A request that breaks these rules is rejected with 400, an unreadable body with 406

Request

$ curl 'https://solo.cloud/public/api/v1/imagelogs/6b38e087-d4ee-4aad-ac08-6de33fa67acc/data' -i -X PUT \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "log_points" : [ {
    "md" : [ {
      "val" : 100.0
    }, {
      "val" : 101.0
    } ],
    "channels" : [ {
      "mnemonic" : "GR",
      "description" : "Gamma Ray",
      "data" : [ {
        "val" : 45.0
      }, {
        "val" : 46.0
      } ]
    }, {
      "mnemonic" : "RES",
      "description" : "Resistivity",
      "data" : [ {
        "val" : 12.0
      }, {
        "val" : 13.0
      } ]
    } ]
  } ]
}'

PUT /public/api/v1/imagelogs/6b38e087-d4ee-4aad-ac08-6de33fa67acc/data HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 428

{
  "log_points" : [ {
    "md" : [ {
      "val" : 100.0
    }, {
      "val" : 101.0
    } ],
    "channels" : [ {
      "mnemonic" : "GR",
      "description" : "Gamma Ray",
      "data" : [ {
        "val" : 45.0
      }, {
        "val" : 46.0
      } ]
    }, {
      "mnemonic" : "RES",
      "description" : "Resistivity",
      "data" : [ {
        "val" : 12.0
      }, {
        "val" : 13.0
      } ]
    } ]
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 205ca39328b5e14cfac61b22e2e16caf

PUT /public/api/v1/imagelogs/{uuid}/data

Path parameter Description
uuid Image log UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
log_points Array Array with exactly one element that holds the MD array and the channels
log_points[].md Array Measured depth values array, at least one value
log_points[].md[].val Number Measured depth value in project depth units. Values must be defined and non-decreasing
log_points[].channels Array Image log channels array, at least one channel
log_points[].channels[].mnemonic String Data channel mnemonic, required string
log_points[].channels[].description String Data channel description, required string
log_points[].channels[].data Array Data channel values array, one value per MD value (same length as md)
log_points[].channels[].data[].val Number Data value, when it is undefined omit it and send "undefined": true
log_points[].channels[].data[].undefined Boolean true if the data value is undefined

Response body

Empty body

Delete image log

Delete image log by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/imagelogs/4fe599f5-a015-44e9-b6ca-8945b63b4350' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>'

DELETE /public/api/v1/imagelogs/4fe599f5-a015-44e9-b6ca-8945b63b4350 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: fe904a8c01e48e7b84a70bfe437a6cce

DELETE /public/api/v1/imagelogs/{uuid}

Path parameter Description
uuid Image log UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

28. Folders

Create lateral folder

Create lateral folder

Request

$ curl 'https://solo.cloud/public/api/v1/wells/087b5136-08c2-4ff3-9c43-9c344043c02e/folders' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "New lateral nested folder",
  "parent_folder" : "945f0847-8925-4219-98cf-5a1a58c19514"
}'

POST /public/api/v1/wells/087b5136-08c2-4ff3-9c43-9c344043c02e/folders HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 102

{
  "name" : "New lateral nested folder",
  "parent_folder" : "945f0847-8925-4219-98cf-5a1a58c19514"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f7e89a0553d6cd193304daac6d83876f
Content-Type: application/json

{
  "uuid" : "96e1e589-8741-464b-978d-36ee8206c2bf"
}

POST /public/api/v1/wells/{uuid}/folders

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Folder name, up to 200 characters
parent_folder String UUID of the parent folder of the same lateral or typewell. Omit it or pass null to create a top-level folder. An unknown folder or a folder of another well is rejected with 400

Response body

Path Type Description
uuid String Created folder UUID

Create typewell folder

Create typewell folder

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/a3dca41e-33d0-4e59-99f3-5b6a7defd368/folders' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "New typewell root folder"
}'

POST /public/api/v1/typewells/a3dca41e-33d0-4e59-99f3-5b6a7defd368/folders HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 41

{
  "name" : "New typewell root folder"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 415af48ffd57442d61d039acd1591b68
Content-Type: application/json

{
  "uuid" : "72a0b6d5-1277-4c2f-b9a3-382d86e28c6d"
}

POST /public/api/v1/typewells/{uuid}/folders

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Folder name, up to 200 characters
parent_folder String UUID of the parent folder of the same lateral or typewell. Omit it or pass null to create a top-level folder. An unknown folder or a folder of another well is rejected with 400

Response body

Path Type Description
uuid String Created folder UUID

Get folders by lateral

Get a list of all folders of the lateral (at any nesting level) with pagination, in creation order. Use relative_path to rebuild the folder tree

Request

$ curl 'https://solo.cloud/public/api/v1/wells/087b5136-08c2-4ff3-9c43-9c344043c02e/folders?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/087b5136-08c2-4ff3-9c43-9c344043c02e/folders?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: f064581a7643ca5dd96b78dc7b9c02f6
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "c6d26b20-69b0-4dbf-88e4-3d1562929624",
    "name" : "Lateral folder"
  }, {
    "uuid" : "45bcb12f-89dd-4add-98dd-bd55825c2a28",
    "name" : "Nested folder",
    "relative_path" : [ "c6d26b20-69b0-4dbf-88e4-3d1562929624" ]
  }, {
    "uuid" : "945f0847-8925-4219-98cf-5a1a58c19514",
    "name" : "Deeply nested folder",
    "relative_path" : [ "c6d26b20-69b0-4dbf-88e4-3d1562929624", "45bcb12f-89dd-4add-98dd-bd55825c2a28" ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 3,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/folders

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Folder UUID
content[].name String Folder name
content[].relative_path Array UUIDs of the ancestor folders, from the top-level folder down to the parent folder. Absent for top-level folders

Get folders by typewell

Get a list of all folders of the typewell (at any nesting level) with pagination, in creation order. Use relative_path to rebuild the folder tree

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/a3dca41e-33d0-4e59-99f3-5b6a7defd368/folders?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/a3dca41e-33d0-4e59-99f3-5b6a7defd368/folders?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: edf74463e19d93092697d98be2bb429c
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "b77a7ab2-2b0f-4375-b3d0-a2a387a87c83",
    "name" : "Typewell folder"
  }, {
    "uuid" : "2ee04caa-c960-4817-bc03-9dd690e9cd9a",
    "name" : "Typewell nested folder",
    "relative_path" : [ "b77a7ab2-2b0f-4375-b3d0-a2a387a87c83" ]
  }, {
    "uuid" : "c6841137-ad8f-4fd1-948e-1bcffb405f3c",
    "name" : "Typewell deeply nested folder",
    "relative_path" : [ "b77a7ab2-2b0f-4375-b3d0-a2a387a87c83", "2ee04caa-c960-4817-bc03-9dd690e9cd9a" ]
  }, {
    "uuid" : "72a0b6d5-1277-4c2f-b9a3-382d86e28c6d",
    "name" : "New typewell root folder"
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 4,
  "first" : true,
  "last" : true
}

GET /public/api/v1/typewells/{uuid}/folders

Path parameter Description
uuid Typewell UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Folder UUID
content[].name String Folder name
content[].relative_path Array UUIDs of the ancestor folders, from the top-level folder down to the parent folder. Absent for top-level folders

29. Completions

Create completion by lateral

Create completion by lateral UUID

Request

$ curl 'https://solo.cloud/public/api/v1/wells/62dc881c-55f5-427a-a367-0f958d2886d6/completions' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Public lateral completion",
  "stages" : [ {
    "name" : "Public lateral stage",
    "top_md" : {
      "val" : 200.0
    },
    "base_md" : {
      "val" : 225.5
    }
  } ]
}'

POST /public/api/v1/wells/62dc881c-55f5-427a-a367-0f958d2886d6/completions HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 191

{
  "name" : "Public lateral completion",
  "stages" : [ {
    "name" : "Public lateral stage",
    "top_md" : {
      "val" : 200.0
    },
    "base_md" : {
      "val" : 225.5
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e1246552d81219684b37e6c04cecd2a8
Content-Type: application/json

{
  "uuid" : "d2aa1622-c378-4212-9948-2d3d62176f83"
}

POST /public/api/v1/wells/{uuid}/completions

Path parameter Description
uuid Lateral UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Completion name, up to 200 characters
stages Array Completion stages
stages[].name String Stage name, required, up to 200 characters
stages[].top_md.val Number Stage top MD value in project units, required, in range [0;100000]
stages[].base_md.val Number Stage base MD value in project units, required, in range [0;100000]
stages[].properties String Ignored: stages are always created with the default display properties

Response body

Path Type Description
uuid String Created completion UUID

Create completion by typewell

Create completion by typewell UUID

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/9764a0ec-fdfc-4756-9d19-57624879f521/completions' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Public typewell completion",
  "stages" : [ {
    "name" : "Public typewell stage",
    "top_md" : {
      "val" : 300.0
    },
    "base_md" : {
      "val" : 330.0
    }
  } ]
}'

POST /public/api/v1/typewells/9764a0ec-fdfc-4756-9d19-57624879f521/completions HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 193

{
  "name" : "Public typewell completion",
  "stages" : [ {
    "name" : "Public typewell stage",
    "top_md" : {
      "val" : 300.0
    },
    "base_md" : {
      "val" : 330.0
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 7ca38e63ccb910f79e51d18545818c63
Content-Type: application/json

{
  "uuid" : "294e8714-1969-40c9-8a07-c2b28c8a816b"
}

POST /public/api/v1/typewells/{uuid}/completions

Path parameter Description
uuid Typewell UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Completion name, up to 200 characters
stages Array Completion stages
stages[].name String Stage name, required, up to 200 characters
stages[].top_md.val Number Stage top MD value in project units, required, in range [0;100000]
stages[].base_md.val Number Stage base MD value in project units, required, in range [0;100000]
stages[].properties String Ignored: stages are always created with the default display properties

Response body

Path Type Description
uuid String Created completion UUID

Create completion attribute

Create completion stage attribute by completion UUID. The attribute is created with the FLOAT type, its stage values are set with Create completion stages and Update completion stage

Request

$ curl 'https://solo.cloud/public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d/attributes' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Treating pressure"
}'

POST /public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d/attributes HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 34

{
  "name" : "Treating pressure"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 834dd00004274bb652b73e1bfa2c8975
Content-Type: application/json

{
  "uuid" : "266dcc83-28e8-4667-bcdf-b1252a61f7df"
}

POST /public/api/v1/completions/{uuid}/attributes

Path parameter Description
uuid Completion UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String Attribute name, up to 200 characters; length (case-insensitive) is reserved
properties String Attribute display properties JSON string; the default properties are used when omitted

Response body

Path Type Description
uuid String Created attribute UUID

Create completion stages

Create completion stages by completion UUID

Request

$ curl 'https://solo.cloud/public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d/stages' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "stages" : [ {
    "name" : "Public created stage",
    "top_md" : {
      "val" : 400.0
    },
    "base_md" : {
      "val" : 425.25
    },
    "attribute_values" : [ {
      "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
      "value" : {
        "val" : 12.25
      }
    } ]
  } ]
}'

POST /public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d/stages HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 303

{
  "stages" : [ {
    "name" : "Public created stage",
    "top_md" : {
      "val" : 400.0
    },
    "base_md" : {
      "val" : 425.25
    },
    "attribute_values" : [ {
      "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
      "value" : {
        "val" : 12.25
      }
    } ]
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 22a51f76abdb8e2fc7b7e18bc5e017df
Content-Type: application/json

{
  "uuids" : [ "016dbdfa-1882-49f0-883e-b6cdef5894f1" ]
}

POST /public/api/v1/completions/{uuid}/stages

Path parameter Description
uuid Completion UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
stages Array Completion stages to create, at least one
stages[].name String Stage name, required, up to 200 characters
stages[].top_md.val Number Stage top MD value in project units, in range [0;100000]
stages[].base_md.val Number Stage base MD value in project units, in range [0;100000]
stages[].properties String Ignored: stages are always created with the default display properties
stages[].attribute_values Array Stage attribute values; each attribute must be a FLOAT attribute of this completion and may be listed once
stages[].attribute_values[].attribute_uuid String Attribute UUID
stages[].attribute_values[].value.val Number Attribute value in range [-1000000000;1000000000]; an entry without a value is skipped

Response body

Path Type Description
uuids Array Created stage UUIDs in request order

Get completions by project and name

Get a list of completions of the project wells whose name exactly matches the name query parameter, with pagination, in creation order. For a virtual project UUID, only completions of the virtual project wells are returned. Completion names do not have to be unique. The name, offset and limit parameters are required. Only stages that have both top and base MD are returned, sorted by base MD descending. Only user-defined FLOAT stage attributes are returned, and a stage lists values only for the attributes that have one

Request

$ curl 'https://solo.cloud/public/api/v1/projects/f7fab60b-b85a-4efb-b3ce-8b8b3ef4e939/completions?name=Lateral%20completion&offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/f7fab60b-b85a-4efb-b3ce-8b8b3ef4e939/completions?name=Lateral%20completion&offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e29ff6fc2daf45d6f94eee59cc45ea1e
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "4aa160a2-c782-4598-961d-fdf61edc6c3d",
    "name" : "Lateral completion",
    "parent_well" : {
      "uuid" : "aa4e3a12-f3d0-4ace-befd-b84d9d0a2df8",
      "name" : "Completion lateral",
      "type" : "WELL"
    },
    "attributes" : [ {
      "uuid" : "266dcc83-28e8-4667-bcdf-b1252a61f7df",
      "name" : "Treating pressure",
      "type" : "FLOAT"
    }, {
      "uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
      "name" : "Proppant concentration",
      "type" : "FLOAT"
    } ],
    "stages" : [ {
      "uuid" : "016dbdfa-1882-49f0-883e-b6cdef5894f1",
      "name" : "Public created stage",
      "stage" : 1,
      "top_md" : {
        "val" : 400.0
      },
      "base_md" : {
        "val" : 425.25
      },
      "length" : {
        "val" : 25.25
      },
      "attribute_values" : [ {
        "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
        "value" : {
          "val" : 12.25
        }
      } ]
    }, {
      "uuid" : "c03073e0-c257-4e05-90aa-494232c21df6",
      "name" : "Second stage",
      "stage" : 2,
      "top_md" : {
        "val" : 130.0
      },
      "base_md" : {
        "val" : 155.25
      },
      "length" : {
        "val" : 25.25
      },
      "attribute_values" : [ {
        "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
        "value" : {
          "val" : 9.75
        }
      } ]
    }, {
      "uuid" : "13d15964-0402-4e6c-91f6-835b7177b2fc",
      "name" : "First stage",
      "stage" : 3,
      "top_md" : {
        "val" : 100.0
      },
      "base_md" : {
        "val" : 125.5
      },
      "length" : {
        "val" : 25.5
      },
      "attribute_values" : [ {
        "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
        "value" : {
          "val" : 8.5
        }
      } ]
    } ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/projects/{uuid}/completions

Path parameter Description
uuid Project UUID
Parameter Description
name Completion name to match exactly
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Completion UUID
content[].name String Completion name
content[].attributes Array Completion stage attributes sorted by name in descending order, case-insensitive, only user-defined FLOAT attributes are listed
content[].attributes[].uuid String Attribute UUID
content[].attributes[].name String Attribute name
content[].attributes[].type String Attribute type, always FLOAT
content[].stages Array Completion stages that have both top and base MD, sorted by base MD descending
content[].stages[].uuid String Stage UUID
content[].stages[].name String Stage name
content[].stages[].stage Number Stage number, from 1 for the stage with the largest base MD
content[].stages[].top_md.val Number Stage top MD value in project units
content[].stages[].base_md.val Number Stage base MD value in project units
content[].stages[].length.val Number Stage length (base MD minus top MD) in project units; absent when top MD is not less than base MD
content[].stages[].attribute_values Array Stage attribute values in the order of attributes, only attributes that have a value for the stage are listed
content[].stages[].attribute_values[].attribute_uuid String Attribute UUID
content[].stages[].attribute_values[].value.val Number Attribute value
content[].parent_well Object Parent well metadata
content[].parent_well.uuid String Parent well UUID
content[].parent_well.name String Parent well name
content[].parent_well.type String Parent well type: WELL for a lateral, TYPEWELL for a typewell

Get completions by lateral

Get a list of completions by lateral UUID with pagination, in creation order. Only stages that have both top and base MD are returned, sorted by base MD descending. Only user-defined FLOAT stage attributes are returned, and a stage lists values only for the attributes that have one

Request

$ curl 'https://solo.cloud/public/api/v1/wells/aa4e3a12-f3d0-4ace-befd-b84d9d0a2df8/completions?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/aa4e3a12-f3d0-4ace-befd-b84d9d0a2df8/completions?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ca23162579b057fc6f981d73e4b36392
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "4aa160a2-c782-4598-961d-fdf61edc6c3d",
    "name" : "Lateral completion",
    "attributes" : [ {
      "uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
      "name" : "Proppant concentration",
      "type" : "FLOAT"
    } ],
    "stages" : [ {
      "uuid" : "c03073e0-c257-4e05-90aa-494232c21df6",
      "name" : "Second stage",
      "stage" : 1,
      "top_md" : {
        "val" : 130.0
      },
      "base_md" : {
        "val" : 155.25
      },
      "length" : {
        "val" : 25.25
      },
      "attribute_values" : [ {
        "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
        "value" : {
          "val" : 9.75
        }
      } ]
    }, {
      "uuid" : "13d15964-0402-4e6c-91f6-835b7177b2fc",
      "name" : "First stage",
      "stage" : 2,
      "top_md" : {
        "val" : 100.0
      },
      "base_md" : {
        "val" : 125.5
      },
      "length" : {
        "val" : 25.5
      },
      "attribute_values" : [ {
        "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
        "value" : {
          "val" : 8.5
        }
      } ]
    } ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/wells/{uuid}/completions

Path parameter Description
uuid Lateral UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Completion UUID
content[].name String Completion name
content[].attributes Array Completion stage attributes sorted by name in descending order, case-insensitive, only user-defined FLOAT attributes are listed
content[].attributes[].uuid String Attribute UUID
content[].attributes[].name String Attribute name
content[].attributes[].type String Attribute type, always FLOAT
content[].stages Array Completion stages that have both top and base MD, sorted by base MD descending
content[].stages[].uuid String Stage UUID
content[].stages[].name String Stage name
content[].stages[].stage Number Stage number, from 1 for the stage with the largest base MD
content[].stages[].top_md.val Number Stage top MD value in project units
content[].stages[].base_md.val Number Stage base MD value in project units
content[].stages[].length.val Number Stage length (base MD minus top MD) in project units; absent when top MD is not less than base MD
content[].stages[].attribute_values Array Stage attribute values in the order of attributes, only attributes that have a value for the stage are listed
content[].stages[].attribute_values[].attribute_uuid String Attribute UUID
content[].stages[].attribute_values[].value.val Number Attribute value

Get completions by typewell

Get a list of completions by typewell UUID with pagination, in creation order. Only stages that have both top and base MD are returned, sorted by base MD descending. Only user-defined FLOAT stage attributes are returned, and a stage lists values only for the attributes that have one

Request

$ curl 'https://solo.cloud/public/api/v1/typewells/b7f34f07-2571-4daf-93ba-9ac6d04df7f6/completions?offset=0&limit=10' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/typewells/b7f34f07-2571-4daf-93ba-9ac6d04df7f6/completions?offset=0&limit=10 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: dcfb658c5276ea26e8870354744fff54
Content-Type: application/json

{
  "content" : [ {
    "uuid" : "13c08cc0-43f9-48a7-ba51-4a67cce232ff",
    "name" : "Typewell completion",
    "attributes" : [ {
      "uuid" : "233ce99f-04b3-4dff-bd02-936f2b2dd279",
      "name" : "Proppant concentration",
      "type" : "FLOAT"
    } ],
    "stages" : [ {
      "uuid" : "b201e309-4a40-4142-b691-9c903f259c31",
      "name" : "Second stage",
      "stage" : 1,
      "top_md" : {
        "val" : 130.0
      },
      "base_md" : {
        "val" : 155.25
      },
      "length" : {
        "val" : 25.25
      },
      "attribute_values" : [ {
        "attribute_uuid" : "233ce99f-04b3-4dff-bd02-936f2b2dd279",
        "value" : {
          "val" : 9.75
        }
      } ]
    }, {
      "uuid" : "10d392f7-ce47-4cff-b5ed-7fe8c3629c39",
      "name" : "First stage",
      "stage" : 2,
      "top_md" : {
        "val" : 100.0
      },
      "base_md" : {
        "val" : 125.5
      },
      "length" : {
        "val" : 25.5
      },
      "attribute_values" : [ {
        "attribute_uuid" : "233ce99f-04b3-4dff-bd02-936f2b2dd279",
        "value" : {
          "val" : 8.5
        }
      } ]
    } ]
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "first" : true,
  "last" : true
}

GET /public/api/v1/typewells/{uuid}/completions

Path parameter Description
uuid Typewell UUID
Parameter Description
offset Index of the first record to return by a request from the list of all records
limit Maximum number of records to return by a request from the list of all records, starting with 'offset'
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Content array
offset Number Index of the first record returned by a request from the list of all records
limit Number Maximum number of records returned by a request from the list of all records, starting with 'offset'
total Number Total number of records
first Boolean true if the current records range is the first, otherwise - false
last Boolean true if the current records range is the last, otherwise - false
content[].uuid String Completion UUID
content[].name String Completion name
content[].attributes Array Completion stage attributes sorted by name in descending order, case-insensitive, only user-defined FLOAT attributes are listed
content[].attributes[].uuid String Attribute UUID
content[].attributes[].name String Attribute name
content[].attributes[].type String Attribute type, always FLOAT
content[].stages Array Completion stages that have both top and base MD, sorted by base MD descending
content[].stages[].uuid String Stage UUID
content[].stages[].name String Stage name
content[].stages[].stage Number Stage number, from 1 for the stage with the largest base MD
content[].stages[].top_md.val Number Stage top MD value in project units
content[].stages[].base_md.val Number Stage base MD value in project units
content[].stages[].length.val Number Stage length (base MD minus top MD) in project units; absent when top MD is not less than base MD
content[].stages[].attribute_values Array Stage attribute values in the order of attributes, only attributes that have a value for the stage are listed
content[].stages[].attribute_values[].attribute_uuid String Attribute UUID
content[].stages[].attribute_values[].value.val Number Attribute value

Update completion

Update completion by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Updated lateral completion"
}'

PATCH /public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 43

{
  "name" : "Updated lateral completion"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3fbe28d1436398432e11985d5a5819ba

PATCH /public/api/v1/completions/{uuid}

Path parameter Description
uuid Completion UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String New completion name, up to 200 characters

Response body

Empty body

Update completion attribute

Update completion attribute name by completion UUID and attribute UUID. Returns 400 if the attribute does not belong to the completion

Request

$ curl 'https://solo.cloud/public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d/attributes/e97b5ddf-48b9-4633-897f-e4ad4440f3b6' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Updated proppant concentration"
}'

PATCH /public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d/attributes/e97b5ddf-48b9-4633-897f-e4ad4440f3b6 HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 47

{
  "name" : "Updated proppant concentration"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: be7116077a4f2b5336ac0465accd396e

PATCH /public/api/v1/completions/{completionUuid}/attributes/{attributeUuid}

Path parameter Description
completionUuid Completion UUID
attributeUuid Attribute UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String New attribute name, up to 200 characters; length (case-insensitive) is reserved

Response body

Empty body

Update completion stage

Update completion stage by stage UUID. An absent field keeps its current value. Only the listed attribute values are changed, an entry without a value clears the attribute value

Request

$ curl 'https://solo.cloud/public/api/v1/stages/13d15964-0402-4e6c-91f6-835b7177b2fc' -i -X PATCH \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "Updated first stage",
  "top_md" : {
    "val" : 105.0
  },
  "base_md" : {
    "val" : 129.5
  },
  "attribute_values" : [ {
    "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
    "value" : {
      "val" : 10.5
    }
  } ]
}'

PATCH /public/api/v1/stages/13d15964-0402-4e6c-91f6-835b7177b2fc HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 251

{
  "name" : "Updated first stage",
  "top_md" : {
    "val" : 105.0
  },
  "base_md" : {
    "val" : 129.5
  },
  "attribute_values" : [ {
    "attribute_uuid" : "e97b5ddf-48b9-4633-897f-e4ad4440f3b6",
    "value" : {
      "val" : 10.5
    }
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 1875c865cbb2020e25f8c3e808ea56c6

PATCH /public/api/v1/stages/{stageUuid}

Path parameter Description
stageUuid Stage UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
name String New stage name, up to 200 characters
top_md.val Number New stage top MD value in project units, in range [0;100000]
base_md.val Number New stage base MD value in project units, in range [0;100000]
attribute_values Array Stage attribute values to change; each attribute must be a FLOAT attribute of the stage completion and may be listed once, attributes that are not listed keep their values
attribute_values[].attribute_uuid String Attribute UUID
attribute_values[].value.val Number New attribute value in range [-1000000000;1000000000]; an entry without a value clears the attribute value

Response body

Empty body

Delete completion

Delete completion by UUID

Request

$ curl 'https://solo.cloud/public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>'

DELETE /public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: c9900ff13fa9bbe5e94702ad361de3e6

DELETE /public/api/v1/completions/{uuid}

Path parameter Description
uuid Completion UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Delete completion attribute

Delete completion attribute by completion UUID and attribute UUID. The attribute values are deleted from all stages of the completion. Returns 400 if the attribute does not belong to the completion

Request

$ curl 'https://solo.cloud/public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d/attributes/e97b5ddf-48b9-4633-897f-e4ad4440f3b6' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>'

DELETE /public/api/v1/completions/4aa160a2-c782-4598-961d-fdf61edc6c3d/attributes/e97b5ddf-48b9-4633-897f-e4ad4440f3b6 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 7a0ff024346360dbc6f32a527d60123a

DELETE /public/api/v1/completions/{completionUuid}/attributes/{attributeUuid}

Path parameter Description
completionUuid Completion UUID
attributeUuid Attribute UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

Delete completion stage

Delete completion stage by stage UUID

Request

$ curl 'https://solo.cloud/public/api/v1/stages/13d15964-0402-4e6c-91f6-835b7177b2fc' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>'

DELETE /public/api/v1/stages/13d15964-0402-4e6c-91f6-835b7177b2fc HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 91765035d1510a524f31f4e9b4b7c7d0

DELETE /public/api/v1/stages/{stageUuid}

Path parameter Description
stageUuid Stage UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

30. Production data

Create or update production curves

Bulk create or update production curves (monthly production data) for wells in the project.

A request may contain multiple wells (laterals or typewells) and multiple curves per well; each well_uuid + metric pair must be unique within the request, otherwise the request is rejected with 400. If any well is not found in the project, the whole request is rejected with 400 ROOT_NOT_FOUND. If a curve for the same well and metric already exists, it is updated: its name, granularity and value type are taken from the request and its points are fully replaced, otherwise a new curve is created. The response lists one result per requested curve in request order.

Point values are production volumes in cubic meters (m3) submitted as plain finite numbers; they are stored as submitted, no unit conversion is performed.

Request

$ curl 'https://solo.cloud/public/api/v1/projects/a89530fd-f611-4a51-8cc7-1fc6adbb76ad/production-curves/bulk' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "wells" : [ {
    "well_uuid" : "80b94d19-8505-40e4-ba33-84163265c4c4",
    "curves" : [ {
      "name" : "Gas production curve",
      "metric" : "GAS",
      "granularity" : "MONTHLY",
      "value_type" : "PERIOD",
      "points" : [ {
        "period_start" : "2024-01-01",
        "value" : 250000.0
      }, {
        "period_start" : "2024-02-01",
        "value" : 235500.5
      } ]
    } ]
  } ]
}'

POST /public/api/v1/projects/a89530fd-f611-4a51-8cc7-1fc6adbb76ad/production-curves/bulk HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 411

{
  "wells" : [ {
    "well_uuid" : "80b94d19-8505-40e4-ba33-84163265c4c4",
    "curves" : [ {
      "name" : "Gas production curve",
      "metric" : "GAS",
      "granularity" : "MONTHLY",
      "value_type" : "PERIOD",
      "points" : [ {
        "period_start" : "2024-01-01",
        "value" : 250000.0
      }, {
        "period_start" : "2024-02-01",
        "value" : 235500.5
      } ]
    } ]
  } ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: dcf2ed5ba657bbf3e0708bd6781258fb
Content-Type: application/json

[ {
  "well_uuid" : "80b94d19-8505-40e4-ba33-84163265c4c4",
  "curve_uuid" : "42665afb-fa52-465d-856e-f8cdc6cef2c1",
  "name" : "Gas production curve",
  "action" : "CREATED"
} ]

POST /public/api/v1/projects/{project_uuid}/production-curves/bulk

Path parameter Description
project_uuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
wells Array Wells to create or update production curves for
wells[].well_uuid String Well UUID (lateral or typewell in the project); a well UUID not found in the project rejects the whole request with 400 ROOT_NOT_FOUND
wells[].curves Array Production curves of the well; each well_uuid + metric pair must be unique within the request
wells[].curves[].name String Production curve name (up to 200 characters); replaces the name of an existing curve
wells[].curves[].metric String Production metric (OIL, GAS, WATER or CONDENSATE)
wells[].curves[].granularity String Points granularity (MONTHLY)
wells[].curves[].value_type String Points value type (PERIOD - each point holds the volume produced during its period, CUMULATIVE is reserved)
wells[].curves[].points Array Production curve points; on update the existing points are fully replaced
wells[].curves[].points[].period_start String Period start (ISO date, yyyy-MM-dd)
wells[].curves[].points[].value Number Production volume for the period in cubic meters (m3), a finite number

Response body

Path Type Description
[].well_uuid String Well UUID
[].curve_uuid String Production curve UUID
[].name String Production curve name
[].action String CREATED if a new curve was created, UPDATED if the existing curve for the same well and metric was updated

Get production curves by well

Get a list of production curves of the well with metadata (without points). Returns an empty array when the well has no production curves.

The caller must have read access to the project. A well that is not a lateral or typewell of the project is rejected with 400 ROOT_NOT_FOUND.

Request

$ curl 'https://solo.cloud/public/api/v1/projects/a89530fd-f611-4a51-8cc7-1fc6adbb76ad/wells/1e5d29e2-7076-4ca1-9248-43a9bb482a94/production-curves' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/projects/a89530fd-f611-4a51-8cc7-1fc6adbb76ad/wells/1e5d29e2-7076-4ca1-9248-43a9bb482a94/production-curves HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: e5080e1c783caada7f3153af53d0a100
Content-Type: application/json

[ {
  "well_uuid" : "1e5d29e2-7076-4ca1-9248-43a9bb482a94",
  "curve_uuid" : "c3618101-88c7-4abd-aec9-7074b7dae2c7",
  "name" : "Oil production curve",
  "metric" : "OIL",
  "granularity" : "MONTHLY",
  "value_type" : "PERIOD",
  "curve_data_version" : 1
} ]

GET /public/api/v1/projects/{project_uuid}/wells/{well_uuid}/production-curves

Path parameter Description
project_uuid Project UUID
well_uuid Well UUID
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
[].well_uuid String Well UUID
[].curve_uuid String Production curve UUID
[].name String Production curve name
[].metric String Production metric (OIL, GAS, WATER or CONDENSATE)
[].granularity String Points granularity (MONTHLY)
[].value_type String Points value type (PERIOD - each point holds the volume produced during its period, CUMULATIVE is reserved)
[].curve_data_version Number Version of the curve points data, changes when the points are updated

Query production curves

Get production curves (monthly production data) with points for the requested wells in the project, sorted by well UUID, then by metric.

Each curve holds one production metric (OIL, GAS, WATER or CONDENSATE) with MONTHLY granularity; point values are volumes in cubic meters (m3), conversion to display units is the consumer's responsibility. Point value is a double value object.

The caller must have read access to the project. The endpoint is available when advanced data management is enabled for the company, otherwise the request is rejected with 403.

Request

$ curl 'https://solo.cloud/public/api/v1/projects/a89530fd-f611-4a51-8cc7-1fc6adbb76ad/production-curves/query' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "well_uuids" : [ "1e5d29e2-7076-4ca1-9248-43a9bb482a94" ],
  "metrics" : [ "OIL" ]
}'

POST /public/api/v1/projects/a89530fd-f611-4a51-8cc7-1fc6adbb76ad/production-curves/query HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 88

{
  "well_uuids" : [ "1e5d29e2-7076-4ca1-9248-43a9bb482a94" ],
  "metrics" : [ "OIL" ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 2e401579eabc565b7ea3a56c5c33a508
Content-Type: application/json

[ {
  "curve_uuid" : "c3618101-88c7-4abd-aec9-7074b7dae2c7",
  "well_uuid" : "1e5d29e2-7076-4ca1-9248-43a9bb482a94",
  "name" : "Oil production curve",
  "metric" : "OIL",
  "granularity" : "MONTHLY",
  "value_type" : "PERIOD",
  "points" : [ {
    "value" : {
      "val" : 1500.0
    },
    "period_start" : "2024-01-01T00:00:00Z"
  }, {
    "value" : {
      "val" : 1420.5
    },
    "period_start" : "2024-02-01T00:00:00Z"
  } ]
} ]

POST /public/api/v1/projects/{project_uuid}/production-curves/query

Path parameter Description
project_uuid Project UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
well_uuids Array Well UUIDs to return production curves for, 1 to 1000 wells, wells outside the project are ignored
metrics Array Production metrics filter (OIL, GAS, WATER, CONDENSATE); empty or missing means all metrics

Response body

Path Type Description
[].curve_uuid String Production curve UUID
[].well_uuid String Well UUID
[].name String Production curve name
[].metric String Production metric (OIL, GAS, WATER or CONDENSATE)
[].granularity String Points granularity (MONTHLY)
[].value_type String Points value type (PERIOD - each point holds the volume produced during its period, CUMULATIVE is reserved)
[].points Array Production curve points
[].points[].period_start String Period start (ISO instant, UTC)
[].points[].value.val Number Production volume for the period in cubic meters (m3)

Delete production curve

Delete a production curve from the project by curve UUID. An unknown curve UUID is rejected with 404

Request

$ curl 'https://solo.cloud/public/api/v1/projects/a89530fd-f611-4a51-8cc7-1fc6adbb76ad/production-curves/320fe160-6a27-4d49-bbd5-075bd112c245' -i -X DELETE \
    -H 'Authorization: Bearer <your_access_token>'

DELETE /public/api/v1/projects/a89530fd-f611-4a51-8cc7-1fc6adbb76ad/production-curves/320fe160-6a27-4d49-bbd5-075bd112c245 HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: ed1aea7ef5ff2129575f09157077ca61

DELETE /public/api/v1/projects/{project_uuid}/production-curves/{curve_uuid}

Path parameter Description
project_uuid Project UUID
curve_uuid Production curve UUID
Header Description
Authorization OAuth2 authorization header

Response body

Empty body

31. Drive files

Files attached to a well in Solo Drive: scanned logs, reports, plans and other documents. A well keeps its files in default folders addressed by a token: drilling_program, well_plans, bha, surveys, well_logs, geosteering_reports, daily_drilling_reports, mud_reports, cementing_reports, casing_pipe_tally, well_schematics, completions, core. Where folder is optional, omitting it addresses the well root. An unknown token is rejected: with 406 in the folder query parameter of listing and upload, with 400 inside the body of move and delete.

filenames takes explicit names or the single element "*" meaning every file of the folder; "*" combined with other names is rejected with 400. Names are matched case-insensitively. A request that names files which do not exist still succeeds with 200, the missing names come back in failed_filenames.

Access follows the role on the well's project and the Solo Drive role matrix: reading for listing (every role), creating for upload and for the target well of a move (Geotech and higher), updating for the source well of a move (Interpreter and higher), deleting for delete (Power Interpreter and Manager). An unknown well is 404. Files uploaded here appear in Solo Drive for the same well, and files added in Solo Drive are listed here.

Get well files

Get the files of one folder of a well, or of the well root when folder is omitted. Folders themselves are not listed. A well that holds no files yet answers 200 with an empty content.

Request

$ curl 'https://solo.cloud/public/api/v1/wells/ef4af66d-f8c1-419a-a8c4-1f913d093adc/files?folder=well_logs' -i -X GET \
    -H 'Authorization: Bearer <your_access_token>'

GET /public/api/v1/wells/ef4af66d-f8c1-419a-a8c4-1f913d093adc/files?folder=well_logs HTTP/1.1
Authorization: Bearer <your_access_token>
Host: solo.cloud

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3bc9c725a0803a9cd73c55d67d70aa50
Content-Type: application/json

{
  "content" : [ {
    "name" : "run1.las",
    "folder" : "well_logs",
    "size_bytes" : 31,
    "created_at" : "2026-10-02T11:06:12.750327Z",
    "updated_at" : "2026-10-02T11:06:12.750299Z"
  }, {
    "name" : "run2.las",
    "folder" : "well_logs",
    "size_bytes" : 31,
    "created_at" : "2026-10-02T11:06:12.822538Z",
    "updated_at" : "2026-10-02T11:06:12.822506Z"
  } ]
}

GET /public/api/v1/wells/{uuid}/files

Path parameter Description
uuid Well UUID
Parameter Description
folder Default folder token: drilling_program, well_plans, bha, surveys, well_logs, geosteering_reports, daily_drilling_reports, mud_reports, cementing_reports, casing_pipe_tally, well_schematics, completions, core. The well root when omitted
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
content Array Files of the folder, empty when it holds none
content[].name String File name
content[].folder String Folder token, absent for a file of the well root
content[].size_bytes Number Size in bytes, null when it is unknown for a legacy file
content[].created_at String Creation time, ISO 8601 UTC
content[].updated_at String Last change time, ISO 8601 UTC

Upload well file

Upload one file into a default folder of a well, well_logs when folder is omitted. The folder is created when the well does not have it yet. Any file format is accepted, up to 250 MB, a larger file is rejected with 413. A file whose name already exists in the folder is stored next to it as name (N).ext, the stored name is returned in file_name. The file is sent in the file part of a multipart/form-data request.

Request

$ curl 'https://solo.cloud/public/api/v1/wells/ef4af66d-f8c1-419a-a8c4-1f913d093adc/files?folder=bha' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: multipart/form-data' \
    -F 'file=@plan.pdf;type=application/pdf' \
    -F 'folder=bha'

POST /public/api/v1/wells/ef4af66d-f8c1-419a-a8c4-1f913d093adc/files?folder=bha HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Host: solo.cloud

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=folder

bha
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file; filename=plan.pdf
Content-Type: application/pdf

%PDF-1.4 sample Solo Drive file
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: af35d90824a57244ba92338ae2a6acf0
Content-Type: application/json

{
  "folder" : "bha",
  "file_name" : "plan.pdf",
  "size_bytes" : 31
}

POST /public/api/v1/wells/{uuid}/files

Path parameter Description
uuid Well UUID
Parameter Description
folder Default folder token: drilling_program, well_plans, bha, surveys, well_logs, geosteering_reports, daily_drilling_reports, mud_reports, cementing_reports, casing_pipe_tally, well_schematics, completions, core. well_logs when omitted
Part Description
file The file to store, any format, up to 250 MB
Header Description
Authorization OAuth2 authorization header

Response body

Path Type Description
file_name String Stored file name: name (N).ext when the folder already held a file with the uploaded name
folder String Folder token the file was stored in
size_bytes Number Stored size in bytes

Move well files

Move files from a folder of the well to a folder of the same or another well of the same company, a target well of another company is rejected with 400. The target well must already hold files, a well without any is rejected with 404, while the target folder is created when missing. A name that already exists in the target folder is stored as name (N).ext. Moving to the same folder is a no-op answered with moved_count: 0.

Request

$ curl 'https://solo.cloud/public/api/v1/wells/ef4af66d-f8c1-419a-a8c4-1f913d093adc/files/move' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "folder" : "surveys",
  "filenames" : [ "survey.las" ],
  "target_well_uuid" : "6a910ddb-afb9-4842-b485-8c7d309e4915",
  "target_folder" : "surveys"
}'

POST /public/api/v1/wells/ef4af66d-f8c1-419a-a8c4-1f913d093adc/files/move HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 159

{
  "folder" : "surveys",
  "filenames" : [ "survey.las" ],
  "target_well_uuid" : "6a910ddb-afb9-4842-b485-8c7d309e4915",
  "target_folder" : "surveys"
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 505aea4cc96a2fee5a714f3a126200cd
Content-Type: application/json

{
  "source_well_uuid" : "ef4af66d-f8c1-419a-a8c4-1f913d093adc",
  "target_well_uuid" : "6a910ddb-afb9-4842-b485-8c7d309e4915",
  "moved_count" : 1,
  "failed_filenames" : [ ]
}

POST /public/api/v1/wells/{uuid}/files/move

Path parameter Description
uuid Source well UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
folder String Source folder. Default folder token: drilling_program, well_plans, bha, surveys, well_logs, geosteering_reports, daily_drilling_reports, mud_reports, cementing_reports, casing_pipe_tally, well_schematics, completions, core. The well root when omitted
filenames Array File names to process, or the single element * for every file of the folder. Names are matched case-insensitively, names that hold no file are returned in failed_filenames
target_well_uuid String Target well UUID of the same company, the source well itself to move between its folders
target_folder String Target folder token, created when missing. The well root when omitted

Response body

Path Type Description
source_well_uuid String Source well UUID
target_well_uuid String Target well UUID
moved_count Number Number of moved files, 0 when source and target are the same folder
failed_filenames Array Requested names that held no file in the source folder

Delete well files

Delete the named files, or every file with "*", from a folder of the well. Deleted files disappear from the listings immediately, the folder itself is kept. A well that holds no files is 404.

Request

$ curl 'https://solo.cloud/public/api/v1/wells/ef4af66d-f8c1-419a-a8c4-1f913d093adc/files/delete' -i -X POST \
    -H 'Authorization: Bearer <your_access_token>' \
    -H 'Content-Type: application/json' \
    -d '{
  "folder" : "bha",
  "filenames" : [ "old-plan.pdf" ]
}'

POST /public/api/v1/wells/ef4af66d-f8c1-419a-a8c4-1f913d093adc/files/delete HTTP/1.1
Authorization: Bearer <your_access_token>
Content-Type: application/json
Host: solo.cloud
Content-Length: 61

{
  "folder" : "bha",
  "filenames" : [ "old-plan.pdf" ]
}

Response

HTTP/1.1 200 OK
X-Solo-Trace-Id: 3815a7aa5415b193e8bc7912237b0114
Content-Type: application/json

{
  "folder" : "bha",
  "well_uuid" : "ef4af66d-f8c1-419a-a8c4-1f913d093adc",
  "deleted_count" : 1,
  "failed_filenames" : [ ]
}

POST /public/api/v1/wells/{uuid}/files/delete

Path parameter Description
uuid Well UUID
Header Description
Authorization OAuth2 authorization header
Body field Type Description
folder String Default folder token: drilling_program, well_plans, bha, surveys, well_logs, geosteering_reports, daily_drilling_reports, mud_reports, cementing_reports, casing_pipe_tally, well_schematics, completions, core. The well root when omitted
filenames Array File names to process, or the single element * for every file of the folder. Names are matched case-insensitively, names that hold no file are returned in failed_filenames

Response body

Path Type Description
well_uuid String Well UUID
folder String Folder token of the request, absent for the well root
deleted_count Number Number of deleted files
failed_filenames Array Requested names that held no file in the folder

Errors

Error response body

All the errors have the following structure:

Path Type Description
message String The error details
type String Type of the error
trace_id String Trace ID of the request
solo_object_uuid String Optional. UUID of the object the error relates to, present only for some errors
solo_object_name String Optional. Name of the object the error relates to, present only for some errors
folder_uuid String Optional. UUID of the folder the error relates to, present only for some errors

400 Bad Request

The request cannot be fulfilled due to bad syntax, validation errors, missing data, etc. The type field tells the reason, for example INVALID_PARAMETER (a required query parameter is missing), INVALID_PARAMETER_TYPE (a parameter value, such as a UUID, is malformed) or INVALID_REQUEST_BODY (the request body is invalid or cannot be read).

Response

HTTP/1.1 400 Bad Request
{
  "message": "Missing required request parameters: offset",
  "trace_id": "d369294dba75b176",
  "type": "INVALID_PARAMETER"
}

401 Unauthorized

The request cannot be fulfilled due to incorrect access credentials, missing or invalid authentication token.

Response

HTTP/1.1 401 Unauthorized
{
  "message": "Unauthorized access",
  "trace_id": "d369294dba75b177",
  "type": "UNAUTHORIZED"
}

403 Forbidden

The request cannot be fulfilled due to lack of access to perform an operation. Endpoints that take a project UUID usually return 403 also when the project does not exist.

Response

HTTP/1.1 403 Forbidden
{
  "message": "Access is denied",
  "trace_id": "d369294dba75b178",
  "type": "FORBIDDEN"
}

404 Not Found

The requested object not found.

Response

HTTP/1.1 404 Not Found
{
  "message": "Object with uuid 1b9f6a0e-3c7d-4a52-9e1f-2d8c5b7a6e40 not found",
  "trace_id": "d369294dba75b180",
  "type": "NOT_FOUND"
}

406 Not Acceptable

Some endpoints reject an invalid parameter value (INVALID_PARAMETER) or a request body in a wrong format (INVALID_REQUEST_BODY_FORMAT, for example grid, polygon, stick and image log uploads) with 406. 406 is also returned when the Accept header does not match what the endpoint produces.

Response

HTTP/1.1 406 Not Acceptable
{
    "message": "Only one of the parameters 'epsg_mnemonic' or 'epsg_crs_code' may be specified at a time",
    "trace_id": "d4e9313ff6267dd5",
    "type": "INVALID_PARAMETER"
}

409 Conflict

Request could not be processed because of conflict in the current state of the resource (such as an edit conflict between multiple simultaneous updates).

Response

HTTP/1.1 409 Conflict
{
    "message": "Requested change cannot be applied",
    "trace_id": "4844645175526a44",
    "type": "NOT_ACCEPTED"
}

415 Unsupported Media Type

The request Content-Type is not supported by the endpoint, for example a body other than JSON is sent to an endpoint that expects application/json.

Response

HTTP/1.1 415 Unsupported Media Type
{
  "message": "Content-Type 'text/plain;charset=ISO-8859-1' is not supported",
  "trace_id": "d369294dba75b179",
  "type": "INVALID_REQUEST_BODY"
}

500 Internal Server Error

The request cannot be fulfilled due to internal server error.

Response

HTTP/1.1 500 Internal server error
{
  "message": "Internal server error",
  "trace_id": "d369294dba75b181",
  "type": "INTERNAL_ERROR"
}

503 Service Unavailable

The request cannot be fulfilled due to temporary server unavailability. Please retry the request later. You can find the detailed information in the error response body.

Response

HTTP/1.1 503 Service Unavailable
{
  "message": "Service is unavailable, please try again later",
  "trace_id": "d369294dba75b182",
  "type": "SERVICE_UNAVAILABLE"
}

License agreement

Copyright 2022 Rogii Inc. These API Terms form a binding "Agreement" between You and Rogii Inc. (“Rogii”) "You," and "your," refers to the individual, company or legal entity that you represent. The Agreement does not grant You any right to access or use: (a) Solo Cloud platform and associated tools and applications (the "Services"); (b) any of Rogii’s non-public application programming interfaces; or (c) the confidential geoscience and drilling data owned by third parties stored in Solo Cloud. If You wish to access the Services, You will be required to enter into separate license agreements with Rogii for the Services.

DEFINITIONS

“Software Application” means software authored by You that accesses or otherwise interoperates with Solo Cloud via the Solo Cloud Public API.

“Solo Cloud” means Rogii’s proprietary multi-tenant cloud system and database which contains confidential geoscience and drilling data owned by third parties.

“Solo Cloud Public API” means a collection of routines, classes, function parameters, protocols, related libraries, tools and other instructions provided in source code or object code form that allow access to or interoperability with Solo Cloud by a Software Application.

“Python SDK” means the software development kit of tools developed by Rogii that enables access to the capabilities and features of Solo Cloud through the utilization of Solo Cloud Public API.

  1. Rogii grants You a world-wide, non-exclusive, revocable limited license, under applicable copyrights, to Use the Solo Cloud Public API or Python SDK, as applicable, only as necessary to develop, test, enable and support interoperability between the Software Application and Solo Cloud.

  2. You will not: (A) access Solo Cloud Public API or Python SDK or their documentation in violation of any law or regulation; (B) access Solo Cloud Public API or Python SDK in any manner that (i) compromises, breaks or circumvents any of Rogii’s technical processes or security measures associated with Solo Cloud, (ii) poses a security vulnerability to customers or users of Solo Cloud, or (iii) tests the vulnerability of Rogii’s systems or networks; (C) access Solo Cloud Public API or Python SDK or their documentation in order to replicate or compete with Solo Cloud; (D) attempt to reverse engineer or otherwise derive source code, trade secrets, or know-how of Solos Cloud API, Python SDK or Solo Cloud; or (E) attempt to use Solo Cloud Public API or Python SDK in a manner that exceeds rate limits, or constitutes excessive or abusive usage.

  3. The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

  4. THE SOLO CLOUD PUBLIC API, PYTHON SDK AND THEIR DOCUMENTATION AND ALL RELATED COMPONENTS AND INFORMATION ARE PROVIDED BY US ON AN "AS IS" AND "AS AVAILABLE" BASIS WITHOUT ANY WARRANTIES OF ANY KIND, AND WE EXPRESSLY DISCLAIM ANY AND ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, TITLE, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. YOU ACKNOWLEDGE THAT ROGII DOES NOT WARRANT THAT THE SOLO CLOUD PUBLIC API OR PYTHON SDK WILL BE UNINTERRUPTED, TIMELY, SECURE, ERROR-FREE, OR BACKWARDS COMPATIBLE.

  5. You shall defend, indemnify and hold harmless Rogii, its affiliates and their respective officers, directors, employees, agents and representatives from any and all claims, damages, liabilities, costs and fees (including reasonable attorneys’ fees) arising from the Software Application. The Parties agree to comply with the following process when Rogii seeks indemnification under this section and specifically that Rogii is to: (i) promptly give You written notice of the claim; (ii) give You sole control of the defense and settlement of the claim (provided that You may not settle any claim unless it unconditionally releases Rogii of all liability); and (iii) provide You, at Your cost, all reasonable assistance.

  6. TO THE EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL ROGII BE RESPONSIBLE OR LIABLE WITH RESPECT TO ANY SUBJECT MATTER OF THIS AGREEMENT UNDER ANY CONTRACT, NEGLIGENCE, STRICT LIABILITY OR OTHER THEORY FOR: (I) LOSS OR INACCURACY OF DATA OR COST OF PROCUREMENT OF SUBSTITUTE GOODS, SERVICES, OR TECHNOLOGY; OR (II) ANY INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES INCLUDING, BUT NOT LIMITED TO LOSS OF REVENUES OR PROFITS; (III) ANY MATTER BEYOND ITS REASONABLE CONTROL; OR (IV) ANY AMOUNT IN THE AGGREGATE OVER $100

  7. Rogii may terminate this Agreement immediately upon written notice if You breach this Agreement. Rogii may, at its sole discretion, reinstate Your ability to use the Solo Cloud Public API if You demonstrate that You have remedied any such breach.

  8. Notwithstanding the foregoing, Sections 4-6 of this Agreement will survive any termination of this Agreement.

HTTP cURL