---
title: "Returns asset tag validation information for the specified list of assets"
method: POST
path: "/assets/GetAssetValidationInformation"
tags: ["Assets"]
---

# Returns asset tag validation information for the specified list of assets

`POST /assets/GetAssetValidationInformation`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/assets/GetAssetValidationInformation`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/assets/GetAssetValidationInformation/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ServiceChannelServicesMessagingAssetsAssetTagScanAuditRecord[]
  - `AssetID` integer, required: Unique numeric identifier of the scanned asset. Must be greater than 0.
  - `TrackingNumber` integer, required: Tracking number of the work order associated with the scanned asset. Must be greater than 0.
  - `WorkOrderID` string: Unique numeric identifier of the work order associated with the scanned asset.
  - `AssetTagStatus` 'Unknown' | 'NotAvailable' | 'NotValidated' | 'PendingValidation' | 'Validated': Validation status of the scanned asset tag. Possible values: • `0`=`Unknown`: Validation status is not determined. • `1`=`NotAvailable`: Asset tag does not exist or cannot be scanned. • `2`=`NotValidated`: Asset tag exists, but validation failed. • `3`=`PendingValidation`: Asset tag has been scanned and is awaiting validation. • `4`=`Validated`: Asset tag has been successfully validated.
  - `ManuallyEntered` boolean: Indicates whether the asset tag value was entered manually instead of being scanned. Possible values: `true` and `false`.
  - `AssetTagNotScannedReason` string: Free‑text explanation of why the tag was not scanned. Must not exceed 50 characters.
  - `ValidationRequired` boolean: Indicates whether this asset requires asset tag validation. Possible values: `true` and `false`. To check whether validation is required, run the [GET/assets/{trackingNumber}/IsValidationRequired](https://developer.servicechannel.com/swagger/index.html#/Assets/GETv3_assets_%7BtrackingNumber%7D_IsValidationRequired) method.
  - `AssetValidated` boolean: Indicates whether the asset has been successfully validated. Possible values: `true` and `false`.
  - `UnableToValidateReasonId` integer: Standardized reason code defining why validation could not be completed. Possible values: • `1`: Cannot find the asset in the database • `2`: Cannot find the asset on site • `3`: New asset • `4`: Other (requires explanation in `OtherReason`) To check the reasons and their IDs, run the [GET/assets/UnableToValidateReasons](https://developer.servicechannel.com/swagger/index.html#/Assets/GETv3_assets_UnableToValidateReasons) method.
  - `OtherReason` string: Free-text explanation of why validation failed. Required when `UnableToValidateReasonId` = `4` (Other).
  - `UnableToScanReasonId` integer: Standardized reason code defining why scanning could not be completed. Possible values: • `1`: Tag Missing • `2`: Tag Damaged • `3`: Scanner Problem • `4`: Other To get the reason codes, run the [GET/assets/UnableToScanReasons](https://developer.servicechannel.com/swagger/index.html#/Assets/GETv3_assets_UnableToScanReasons%3FsubscriberId%3D%7BsubscriberId%7D) method.

## Response `200`

Request succeeded

- ServiceChannelServicesMessagingAssetsAssetTagScanAuditRecord[]
  - `AssetID` integer, required: Unique numeric identifier of the scanned asset. Must be greater than 0.
  - `TrackingNumber` integer, required: Tracking number of the work order associated with the scanned asset. Must be greater than 0.
  - `WorkOrderID` string: Unique numeric identifier of the work order associated with the scanned asset.
  - `AssetTagStatus` 'Unknown' | 'NotAvailable' | 'NotValidated' | 'PendingValidation' | 'Validated': Validation status of the scanned asset tag. Possible values: • `0`=`Unknown`: Validation status is not determined. • `1`=`NotAvailable`: Asset tag does not exist or cannot be scanned. • `2`=`NotValidated`: Asset tag exists, but validation failed. • `3`=`PendingValidation`: Asset tag has been scanned and is awaiting validation. • `4`=`Validated`: Asset tag has been successfully validated.
  - `ManuallyEntered` boolean: Indicates whether the asset tag value was entered manually instead of being scanned. Possible values: `true` and `false`.
  - `AssetTagNotScannedReason` string: Free‑text explanation of why the tag was not scanned. Must not exceed 50 characters.
  - `ValidationRequired` boolean: Indicates whether this asset requires asset tag validation. Possible values: `true` and `false`. To check whether validation is required, run the [GET/assets/{trackingNumber}/IsValidationRequired](https://developer.servicechannel.com/swagger/index.html#/Assets/GETv3_assets_%7BtrackingNumber%7D_IsValidationRequired) method.
  - `AssetValidated` boolean: Indicates whether the asset has been successfully validated. Possible values: `true` and `false`.
  - `UnableToValidateReasonId` integer: Standardized reason code defining why validation could not be completed. Possible values: • `1`: Cannot find the asset in the database • `2`: Cannot find the asset on site • `3`: New asset • `4`: Other (requires explanation in `OtherReason`) To check the reasons and their IDs, run the [GET/assets/UnableToValidateReasons](https://developer.servicechannel.com/swagger/index.html#/Assets/GETv3_assets_UnableToValidateReasons) method.
  - `OtherReason` string: Free-text explanation of why validation failed. Required when `UnableToValidateReasonId` = `4` (Other).
  - `UnableToScanReasonId` integer: Standardized reason code defining why scanning could not be completed. Possible values: • `1`: Tag Missing • `2`: Tag Damaged • `3`: Scanner Problem • `4`: Other To get the reason codes, run the [GET/assets/UnableToScanReasons](https://developer.servicechannel.com/swagger/index.html#/Assets/GETv3_assets_UnableToScanReasons%3FsubscriberId%3D%7BsubscriberId%7D) method.

## Other responses

- `400`: Request did NOT succeed and the error information is in the response

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)