GET Assets?assetId={assetId}&includeAllAncestors={includeAllAncestors}
Retrieves an asset by its Id.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| assetId |
Id of the asset |
globally unique identifier |
Required |
| includeAllAncestors |
Indicates whether to include all ancestor assets and groups or just the immediate parents |
boolean |
Default value is False |
Body Parameters
None.
Response Information
Resource Description
On success, the asset.
| Name | Description | Type | Additional information |
|---|---|---|---|
| Data | Asset |
None. |
|
| Total | integer |
None. |
|
| Message | string |
None. |
Response Formats
application/json, text/json
Sample:
{
"Data": {
"AssetId": "e0fdb849-9a12-45cd-9b88-c16265c0835a",
"Name": "sample string 1",
"Description": "sample string 2",
"DisplayOrder": 1,
"AssetType": {
"AssetTypeId": "a29dc656-6762-491d-8f9f-d78c0bf9abe8",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "f9c6f908-efbd-4c39-8eb6-cab15f7cdff8",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 8"
},
"AssetGroup": {
"AssetGroupId": "e28d2036-158b-49f6-af55-38de70aa3bd8",
"Name": "sample string 1",
"Description": "sample string 2",
"ParentGroup": null,
"DisplayOrder": 1,
"FormValueNeededDate": "2026-10-04T02:43:11.035227-07:00",
"MeasurementValueNeededDate": "2026-10-04T02:43:11.035227-07:00",
"SourceSystemId": "sample string 3",
"CompanyId": "1ced1a41-c812-400a-ac37-55482b4d1a31",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 6"
},
"ParentAsset": null,
"Location": "sample string 3",
"Barcode": {
"Format": 0,
"Code": "sample string 1"
},
"State": {
"StateId": "a73185c3-0ce8-4277-9da5-61fb00d2d95b",
"EffectiveDate": "2026-10-04T02:43:11.035227-07:00",
"StateType": {
"StateTypeId": "e0289593-87d4-49c7-9b8c-a7525a85b749",
"Name": "sample string 1",
"IsOperational": true,
"AssetType": {
"AssetTypeId": "a29dc656-6762-491d-8f9f-d78c0bf9abe8",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "f9c6f908-efbd-4c39-8eb6-cab15f7cdff8",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 3",
"CompanyId": "10850f64-b0bc-4467-bbed-8aeb3e223eda",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 6"
},
"SourceSystemId": "sample string 1",
"CompanyId": "7d333234-26cd-4692-ac24-f6e515e99cca",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 4"
},
"Status": {
"StatusId": "df7ca65b-b5d0-4631-8e40-77cf9bb3fccb",
"EffectiveDate": "2026-10-04T02:43:11.035227-07:00",
"StatusType": {
"StatusTypeId": "df1c6d67-1d5b-4833-9e71-07729b9dbf99",
"Name": "sample string 1",
"IsProducing": true,
"IsInjecting": true,
"AssetType": {
"AssetTypeId": "a29dc656-6762-491d-8f9f-d78c0bf9abe8",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "f9c6f908-efbd-4c39-8eb6-cab15f7cdff8",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 4",
"CompanyId": "34db3bc8-48e5-4657-9782-3be5b077650f",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "6ca61ea4-0bf3-417d-8f4c-721f660e9e41",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 4"
},
"WellPurpose": {
"WellPurposeId": "daac4225-b4c3-4b5b-a6e7-417f55d70ac2",
"EffectiveDate": "2026-10-04T02:43:11.035227-07:00",
"WellPurposeType": {
"WellPurposeTypeId": "6a571990-2faf-4893-9e43-b16e718e6725",
"IsProducer": true,
"IsInjector": true,
"Name": "sample string 3",
"SourceSystemId": "sample string 4",
"CompanyId": "d9e3856d-1684-499e-ad38-dc9120c8ed46",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "7b386907-0a95-4297-b76d-5d51739f71a3",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 4"
},
"FormValueNeededDate": "2026-10-04T02:43:11.035227-07:00",
"MeasurementValueNeededDate": "2026-10-04T02:43:11.035227-07:00",
"HasChildren": true,
"SourceSystemId": "sample string 5",
"CompanyId": "19e3eeb2-d94d-4eed-9629-1a446be62791",
"CreateDate": "2026-10-04T02:43:11.035227-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-10-04T02:43:11.035227-07:00",
"LastModifiedUser": "sample string 8"
},
"Total": 1,
"Message": "sample string 1"
}