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": "4aac4ad9-e7e7-4c6a-92c6-e0089a2e7060",
"Name": "sample string 1",
"Description": "sample string 2",
"DisplayOrder": 1,
"AssetType": {
"AssetTypeId": "2c50bf21-e893-4cb0-9513-b56f9f09037f",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "125d58c1-e7ff-44f9-b049-cfb933bdd284",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 8"
},
"AssetGroup": {
"AssetGroupId": "65ed755e-4838-4353-a6f5-df60a745d990",
"Name": "sample string 1",
"Description": "sample string 2",
"ParentGroup": null,
"DisplayOrder": 1,
"FormValueNeededDate": "2026-11-21T11:57:15.7656805-08:00",
"MeasurementValueNeededDate": "2026-11-21T11:57:15.7656805-08:00",
"SourceSystemId": "sample string 3",
"CompanyId": "36b4bfed-7e42-4eb7-88d4-e88676fb6f03",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 6"
},
"ParentAsset": null,
"Location": "sample string 3",
"Barcode": {
"Format": 0,
"Code": "sample string 1"
},
"State": {
"StateId": "e39f72c1-0f70-4eac-ade8-3a5e04e40fa8",
"EffectiveDate": "2026-11-21T11:57:15.7656805-08:00",
"StateType": {
"StateTypeId": "2918ca8e-4e41-4e14-ae15-e60d88ac5a9f",
"Name": "sample string 1",
"IsOperational": true,
"AssetType": {
"AssetTypeId": "2c50bf21-e893-4cb0-9513-b56f9f09037f",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "125d58c1-e7ff-44f9-b049-cfb933bdd284",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 3",
"CompanyId": "be1e6e97-606b-4935-8698-51017d013bfa",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 6"
},
"SourceSystemId": "sample string 1",
"CompanyId": "ee961a90-cf10-4a51-9713-d314cf558c58",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 4"
},
"Status": {
"StatusId": "4be06c7c-b448-426c-98ea-751fa73e553b",
"EffectiveDate": "2026-11-21T11:57:15.7656805-08:00",
"StatusType": {
"StatusTypeId": "6b19cc21-f883-4c04-8414-2b852d103809",
"Name": "sample string 1",
"IsProducing": true,
"IsInjecting": true,
"AssetType": {
"AssetTypeId": "2c50bf21-e893-4cb0-9513-b56f9f09037f",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "125d58c1-e7ff-44f9-b049-cfb933bdd284",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 4",
"CompanyId": "3bc37916-5e06-45f4-8fcd-715ec663a9d2",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "49492e71-b642-47cb-a9bd-683cc3a18b9b",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 4"
},
"WellPurpose": {
"WellPurposeId": "4165a6bc-5abc-4eff-bd50-22eb41389d69",
"EffectiveDate": "2026-11-21T11:57:15.7656805-08:00",
"WellPurposeType": {
"WellPurposeTypeId": "afeff95a-e03f-4a2b-9057-b11d0296306d",
"IsProducer": true,
"IsInjector": true,
"Name": "sample string 3",
"SourceSystemId": "sample string 4",
"CompanyId": "a3987b6a-0468-4ec4-8332-6562c4de8844",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "c7a94d6e-29e2-4851-b941-cd4fdd6d6f67",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 4"
},
"FormValueNeededDate": "2026-11-21T11:57:15.7656805-08:00",
"MeasurementValueNeededDate": "2026-11-21T11:57:15.7656805-08:00",
"HasChildren": true,
"SourceSystemId": "sample string 5",
"CompanyId": "608fcc29-7e74-45eb-a355-73c4295db80d",
"CreateDate": "2026-11-21T11:57:15.7656805-08:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-11-21T11:57:15.7656805-08:00",
"LastModifiedUser": "sample string 8"
},
"Total": 1,
"Message": "sample string 1"
}