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": "57d62bd9-3b8a-4b23-b227-2293066424a3",
"Name": "sample string 1",
"Description": "sample string 2",
"DisplayOrder": 1,
"AssetType": {
"AssetTypeId": "67f8f9ee-97d9-41aa-9d4a-0b601f90bc0b",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "6bb35920-7037-4d5f-997d-75bd2778f955",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 8"
},
"AssetGroup": {
"AssetGroupId": "13e6c412-6b96-4ea6-94b5-9e11f94ad8d0",
"Name": "sample string 1",
"Description": "sample string 2",
"ParentGroup": null,
"DisplayOrder": 1,
"FormValueNeededDate": "2026-04-18T05:01:01.1525739-07:00",
"MeasurementValueNeededDate": "2026-04-18T05:01:01.1525739-07:00",
"SourceSystemId": "sample string 3",
"CompanyId": "c517bd93-8b5c-4824-a01c-95bb9f33a785",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 6"
},
"ParentAsset": null,
"Location": "sample string 3",
"Barcode": {
"Format": 0,
"Code": "sample string 1"
},
"State": {
"StateId": "9d10b526-48bf-413f-b890-86f74fba9d78",
"EffectiveDate": "2026-04-18T05:01:01.1525739-07:00",
"StateType": {
"StateTypeId": "3f45235f-2def-45e5-ab13-09ca1d55810f",
"Name": "sample string 1",
"IsOperational": true,
"AssetType": {
"AssetTypeId": "67f8f9ee-97d9-41aa-9d4a-0b601f90bc0b",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "6bb35920-7037-4d5f-997d-75bd2778f955",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 3",
"CompanyId": "9a891aa1-c988-44ee-9afb-9e118f0d3485",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 6"
},
"SourceSystemId": "sample string 1",
"CompanyId": "0d22af82-b101-42bc-8ab0-8f48097900aa",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 4"
},
"Status": {
"StatusId": "c0ae073f-3eeb-4c3f-8c89-d7a761dfac95",
"EffectiveDate": "2026-04-18T05:01:01.1525739-07:00",
"StatusType": {
"StatusTypeId": "c947aea4-baf9-461c-b048-fe8384275b44",
"Name": "sample string 1",
"IsProducing": true,
"IsInjecting": true,
"AssetType": {
"AssetTypeId": "67f8f9ee-97d9-41aa-9d4a-0b601f90bc0b",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "6bb35920-7037-4d5f-997d-75bd2778f955",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 4",
"CompanyId": "e1679091-e9a6-4cc7-978c-1cec493d3cda",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "e5c02807-4d08-40cc-b1eb-db52e5178f21",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 4"
},
"WellPurpose": {
"WellPurposeId": "b472dc4f-49ca-4ea3-8709-14bc4eff325e",
"EffectiveDate": "2026-04-18T05:01:01.1525739-07:00",
"WellPurposeType": {
"WellPurposeTypeId": "270fa6cc-f721-4214-8e96-82122f1a7cca",
"IsProducer": true,
"IsInjector": true,
"Name": "sample string 3",
"SourceSystemId": "sample string 4",
"CompanyId": "cc95e636-c495-432a-9a2c-287be47b0b82",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "5402122e-211d-4f09-a0ad-aa71b91840e6",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 4"
},
"FormValueNeededDate": "2026-04-18T05:01:01.1525739-07:00",
"MeasurementValueNeededDate": "2026-04-18T05:01:01.1525739-07:00",
"HasChildren": true,
"SourceSystemId": "sample string 5",
"CompanyId": "b45aae77-0589-4320-a3c9-7fd68ce7afa8",
"CreateDate": "2026-04-18T05:01:01.1525739-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-04-18T05:01:01.1525739-07:00",
"LastModifiedUser": "sample string 8"
},
"Total": 1,
"Message": "sample string 1"
}