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": "7e13b268-6f59-4511-bae2-4688aeb3e006",
"Name": "sample string 1",
"Description": "sample string 2",
"DisplayOrder": 1,
"AssetType": {
"AssetTypeId": "2ebd1b04-facb-45fc-978c-45b077942efc",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "e2b88576-ceb8-4f74-9db5-f8635a3daf4a",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 8"
},
"AssetGroup": {
"AssetGroupId": "d0f52ae6-59f1-4bdd-a141-d2f03658979e",
"Name": "sample string 1",
"Description": "sample string 2",
"ParentGroup": null,
"DisplayOrder": 1,
"FormValueNeededDate": "2026-01-26T00:04:46.3538945-08:00",
"MeasurementValueNeededDate": "2026-01-26T00:04:46.3538945-08:00",
"SourceSystemId": "sample string 3",
"CompanyId": "61647125-c7dd-4a38-bd60-f9eb51dc2562",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 6"
},
"ParentAsset": null,
"Location": "sample string 3",
"Barcode": {
"Format": 0,
"Code": "sample string 1"
},
"State": {
"StateId": "c4d1680c-9cca-4ab3-b246-6264d1388a54",
"EffectiveDate": "2026-01-26T00:04:46.3538945-08:00",
"StateType": {
"StateTypeId": "4a1ec85c-bb8d-45e8-af4b-062284b11d9b",
"Name": "sample string 1",
"IsOperational": true,
"AssetType": {
"AssetTypeId": "2ebd1b04-facb-45fc-978c-45b077942efc",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "e2b88576-ceb8-4f74-9db5-f8635a3daf4a",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 3",
"CompanyId": "242802fd-e60a-48a2-a46f-b355976688cc",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 5",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 6"
},
"SourceSystemId": "sample string 1",
"CompanyId": "78be9e3f-897e-4808-8ef3-2a2b6c177c73",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 4"
},
"Status": {
"StatusId": "7c8c72b5-e909-48e5-9261-74fe08fbfe78",
"EffectiveDate": "2026-01-26T00:04:46.3538945-08:00",
"StatusType": {
"StatusTypeId": "a4aee1b9-2735-49ae-8981-970636c35e43",
"Name": "sample string 1",
"IsProducing": true,
"IsInjecting": true,
"AssetType": {
"AssetTypeId": "2ebd1b04-facb-45fc-978c-45b077942efc",
"Name": "sample string 1",
"Description": "sample string 2",
"IsWell": true,
"DisplayColor": "sample string 4",
"SourceSystemId": "sample string 5",
"CompanyId": "e2b88576-ceb8-4f74-9db5-f8635a3daf4a",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 8"
},
"SourceSystemId": "sample string 4",
"CompanyId": "38648595-ab3f-494f-a094-8bf0dee646b9",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "3b93a1c9-a1ca-4b37-ba53-93da6bc4df5b",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 4"
},
"WellPurpose": {
"WellPurposeId": "981cd90b-0290-4c8d-a775-a6d9f27576cd",
"EffectiveDate": "2026-01-26T00:04:46.3538945-08:00",
"WellPurposeType": {
"WellPurposeTypeId": "ccc984c3-fabd-4a4f-a295-2ad8e47d897e",
"IsProducer": true,
"IsInjector": true,
"Name": "sample string 3",
"SourceSystemId": "sample string 4",
"CompanyId": "8fe376cc-a2d5-4a5c-b7a9-6d3f72c9f5c3",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 6",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 7"
},
"SourceSystemId": "sample string 1",
"CompanyId": "ba99b787-1bcf-459e-beea-55e6bd9c9d19",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 3",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 4"
},
"FormValueNeededDate": "2026-01-26T00:04:46.3538945-08:00",
"MeasurementValueNeededDate": "2026-01-26T00:04:46.3538945-08:00",
"HasChildren": true,
"SourceSystemId": "sample string 5",
"CompanyId": "e2e57960-d0e3-42d5-8f6c-3ecdd50dc283",
"CreateDate": "2026-01-26T00:04:46.3538945-08:00",
"CreateUser": "sample string 7",
"LastModifiedDate": "2026-01-26T00:04:46.3538945-08:00",
"LastModifiedUser": "sample string 8"
},
"Total": 1,
"Message": "sample string 1"
}