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": "15271d6f-fbed-4a24-9f8c-b2308b00e3f5",
"Name": "sample string 1",
"Description": "sample string 2",
"DisplayOrder": 1,
"AssetType": {
"AssetTypeId": "88924845-56f6-4f9d-b5e6-b227679b7ebd",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "7dd633b9-6c4a-4f95-b15a-37cd5e1a35fd",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 8"
},
"AssetGroup": {
"AssetGroupId": "2b6fb9bf-4c21-4bba-95ca-7c7953af26aa",
"Name": "sample string 1",
"Description": "sample string 2",
"ParentGroup": null,
"DisplayOrder": 1,
"FormValueNeededDate": "2026-04-17T01:12:56.7093132-07:00",
"MeasurementValueNeededDate": "2026-04-17T01:12:56.7093132-07:00",
"SourceSystemId": "sample string 3",
"CompanyId": "859fc0df-b8e7-4d6f-9a21-1125629fc61b",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 6"
},
"ParentAsset": null,
"Location": "sample string 3",
"Barcode": {
"Format": 0,
"Code": "sample string 1"
},
"State": {
"StateId": "8dd11af3-538c-4ecc-ba63-a1b53ed3e450",
"EffectiveDate": "2026-04-17T01:12:56.7093132-07:00",
"StateType": {
"StateTypeId": "176ad372-b345-4b60-aebb-655b732025e0",
"Name": "sample string 1",
"IsOperational": true,
"AssetType": {
"AssetTypeId": "88924845-56f6-4f9d-b5e6-b227679b7ebd",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "7dd633b9-6c4a-4f95-b15a-37cd5e1a35fd",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 3",
"CompanyId": "0ee07264-eeb7-4b5b-85a1-5c5f7e41c68c",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 6"
},
"SourceSystemId": "sample string 1",
"CompanyId": "620bb7f9-0a79-4ab4-8a7b-e17d79827300",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 4"
},
"Status": {
"StatusId": "118280f2-404a-4f8d-8c5a-f3eb63f4cc3f",
"EffectiveDate": "2026-04-17T01:12:56.7093132-07:00",
"StatusType": {
"StatusTypeId": "137b5865-0f47-431a-b14c-1b2ea00f7aa4",
"Name": "sample string 1",
"IsProducing": true,
"IsInjecting": true,
"AssetType": {
"AssetTypeId": "88924845-56f6-4f9d-b5e6-b227679b7ebd",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "7dd633b9-6c4a-4f95-b15a-37cd5e1a35fd",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 4",
"CompanyId": "b9301284-212d-4d52-84fd-35973fca7a27",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "a2087217-385e-468a-9541-1e499b069e0c",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 4"
},
"WellPurpose": {
"WellPurposeId": "99b4169f-1a47-4629-88a8-1e6294c4b43e",
"EffectiveDate": "2026-04-17T01:12:56.7093132-07:00",
"WellPurposeType": {
"WellPurposeTypeId": "d6a19273-b9ba-4054-aa2a-2d12db806142",
"IsProducer": true,
"IsInjector": true,
"Name": "sample string 3",
"SourceSystemId": "sample string 4",
"CompanyId": "4142a221-1d8e-4a09-8c00-2f33b48f0f4c",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "225c2300-d8f1-45ba-9a7d-4e3c6433c8ca",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 4"
},
"FormValueNeededDate": "2026-04-17T01:12:56.7093132-07:00",
"MeasurementValueNeededDate": "2026-04-17T01:12:56.7093132-07:00",
"HasChildren": true,
"SourceSystemId": "sample string 5",
"CompanyId": "70475608-bbdf-48b3-9344-ba33dd5e2acf",
"CreateDate": "2026-04-17T01:12:56.7093132-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-04-17T01:12:56.7093132-07:00",
"LastModifiedUser": "sample string 8"
},
"Total": 1,
"Message": "sample string 1"
}