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": "d29f35e9-db90-4015-b5ce-aea62cc1d5ef",
"Name": "sample string 1",
"Description": "sample string 2",
"DisplayOrder": 1,
"AssetType": {
"AssetTypeId": "46fecf24-942b-4ece-9e2f-56515f909db4",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "b8c01de2-4411-410a-b1ec-6d63b93ee336",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 8"
},
"AssetGroup": {
"AssetGroupId": "7fd595c2-9181-4ac1-bce6-d1d098ef63ea",
"Name": "sample string 1",
"Description": "sample string 2",
"ParentGroup": null,
"DisplayOrder": 1,
"FormValueNeededDate": "2026-06-21T05:15:08.114611-07:00",
"MeasurementValueNeededDate": "2026-06-21T05:15:08.114611-07:00",
"SourceSystemId": "sample string 3",
"CompanyId": "c437ecf0-457e-4935-9b8a-ad65cd10bb60",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 6"
},
"ParentAsset": null,
"Location": "sample string 3",
"Barcode": {
"Format": 0,
"Code": "sample string 1"
},
"State": {
"StateId": "afcd723a-714a-458e-8edb-b441c8fbe030",
"EffectiveDate": "2026-06-21T05:15:08.114611-07:00",
"StateType": {
"StateTypeId": "9ad7830c-6c84-4ba3-bf07-623dda2669ef",
"Name": "sample string 1",
"IsOperational": true,
"AssetType": {
"AssetTypeId": "46fecf24-942b-4ece-9e2f-56515f909db4",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "b8c01de2-4411-410a-b1ec-6d63b93ee336",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 3",
"CompanyId": "f0a53433-f4f2-4ee7-8183-159ea627b2de",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 6"
},
"SourceSystemId": "sample string 1",
"CompanyId": "55dfd045-cf93-40c0-aaa3-59db09f7342b",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 4"
},
"Status": {
"StatusId": "b42875f9-a97f-4f68-beb0-eb96369047c2",
"EffectiveDate": "2026-06-21T05:15:08.114611-07:00",
"StatusType": {
"StatusTypeId": "7beb7bfd-aed9-485d-805d-b86282499da3",
"Name": "sample string 1",
"IsProducing": true,
"IsInjecting": true,
"AssetType": {
"AssetTypeId": "46fecf24-942b-4ece-9e2f-56515f909db4",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "b8c01de2-4411-410a-b1ec-6d63b93ee336",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 4",
"CompanyId": "2a513729-faca-4614-affc-48ae6869ad63",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "4553f99b-a5a3-4eb9-ae53-17bb8e443aaa",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 4"
},
"WellPurpose": {
"WellPurposeId": "09b0f6a6-fa63-44f3-ba39-6ff1eff2cbb5",
"EffectiveDate": "2026-06-21T05:15:08.114611-07:00",
"WellPurposeType": {
"WellPurposeTypeId": "0bc3e702-8508-446b-b6f9-6ef822103260",
"IsProducer": true,
"IsInjector": true,
"Name": "sample string 3",
"SourceSystemId": "sample string 4",
"CompanyId": "f261de60-bac7-45ae-8e91-a897b28e8ff6",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "bbfe9a65-47cd-41ea-9ab3-f632364fa5de",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 4"
},
"FormValueNeededDate": "2026-06-21T05:15:08.114611-07:00",
"MeasurementValueNeededDate": "2026-06-21T05:15:08.114611-07:00",
"HasChildren": true,
"SourceSystemId": "sample string 5",
"CompanyId": "89cb4044-d136-4763-9d65-d079a4485135",
"CreateDate": "2026-06-21T05:15:08.114611-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-06-21T05:15:08.114611-07:00",
"LastModifiedUser": "sample string 8"
},
"Total": 1,
"Message": "sample string 1"
}