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": "546a76e6-e2cd-4b3f-a47d-d4180616ba70",
"Name": "sample string 1",
"Description": "sample string 2",
"DisplayOrder": 1,
"AssetType": {
"AssetTypeId": "fafb5728-f613-401d-ab26-336753d5147e",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "f0cdcfd4-2ff5-4508-905e-7d481806fd67",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 8"
},
"AssetGroup": {
"AssetGroupId": "11fd868d-4f5b-4df4-b0cf-82c65486bed8",
"Name": "sample string 1",
"Description": "sample string 2",
"ParentGroup": null,
"DisplayOrder": 1,
"FormValueNeededDate": "2026-03-22T20:06:47.4059012-07:00",
"MeasurementValueNeededDate": "2026-03-22T20:06:47.4059012-07:00",
"SourceSystemId": "sample string 3",
"CompanyId": "6fa7b157-0c6c-4f93-a72b-9317ca38791a",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 6"
},
"ParentAsset": null,
"Location": "sample string 3",
"Barcode": {
"Format": 0,
"Code": "sample string 1"
},
"State": {
"StateId": "7cfeaeb2-949f-41db-a3d5-6a94a2ef64d1",
"EffectiveDate": "2026-03-22T20:06:47.4059012-07:00",
"StateType": {
"StateTypeId": "921d64f3-7b28-44e5-8767-a9665628c389",
"Name": "sample string 1",
"IsOperational": true,
"AssetType": {
"AssetTypeId": "fafb5728-f613-401d-ab26-336753d5147e",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "f0cdcfd4-2ff5-4508-905e-7d481806fd67",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 3",
"CompanyId": "06338076-6f22-4047-819a-a57894d42976",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 6"
},
"SourceSystemId": "sample string 1",
"CompanyId": "330ca8b9-2521-48a0-a264-b61f48780588",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 4"
},
"Status": {
"StatusId": "a2b4ad02-afbb-4d6a-b318-8d4debf1daf4",
"EffectiveDate": "2026-03-22T20:06:47.4059012-07:00",
"StatusType": {
"StatusTypeId": "24166dac-0a9a-4cf8-9142-87c04ba17e69",
"Name": "sample string 1",
"IsProducing": true,
"IsInjecting": true,
"AssetType": {
"AssetTypeId": "fafb5728-f613-401d-ab26-336753d5147e",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "f0cdcfd4-2ff5-4508-905e-7d481806fd67",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 4",
"CompanyId": "a1d6000b-f771-4d5a-a9ac-550e106589d1",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "4ad31fd9-3fff-49ef-a877-254673ace481",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 4"
},
"WellPurpose": {
"WellPurposeId": "4c238aa6-d647-42bf-9026-2211011bf0da",
"EffectiveDate": "2026-03-22T20:06:47.4059012-07:00",
"WellPurposeType": {
"WellPurposeTypeId": "26b597bd-926c-4d46-ab6e-46787e21ee5a",
"IsProducer": true,
"IsInjector": true,
"Name": "sample string 3",
"SourceSystemId": "sample string 4",
"CompanyId": "e7dd5f30-5150-476b-9a74-f28438dd3b73",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "77164438-f30e-4e36-9823-c124ebaafe90",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 4"
},
"FormValueNeededDate": "2026-03-22T20:06:47.4059012-07:00",
"MeasurementValueNeededDate": "2026-03-22T20:06:47.4059012-07:00",
"HasChildren": true,
"SourceSystemId": "sample string 5",
"CompanyId": "1af51b9e-434e-4c45-8b25-16388ef5f3e2",
"CreateDate": "2026-03-22T20:06:47.4059012-07:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-03-22T20:06:47.4059012-07:00",
"LastModifiedUser": "sample string 8"
},
"Total": 1,
"Message": "sample string 1"
}