POST api/tirescanv2

Adds a new tire scan.

Request Information

URI Parameters

None.

Body Parameters

The scanner data to add in JSON format.

TireScanV2_0Data
NameDescriptionTypeAdditional information
brakingDistanceInPercent

Gets or sets the braking distance.

 decimal number

None.
branchId

Gets or sets the branch identifier.

 integer

None.
correlationId

Gets or sets the correlation identifier.
This can be used to link/identify the received/logged HttpRequest scanner data and the stored DD database scan data.

 globally unique identifier

None.
scanDateTime

Gets or sets the scan date and time.

 date

None.
scannerBrand

Gets or sets the scanner brand.

 string

None.
scannerType

Gets or sets the scanner type.

 string

None.
scannerId

The scanner identifier. This might be one value or a composite value depending on the scanner brand, model and version.

 string

None.
scannerFallbackDisplayName

Gets or sets the fallback display name of the scanner.

 string

None.
season

Gets or sets the season (winter/summer tires).

 Season

None.
licensePlate

Gets or sets the license plate number.

 string

None.
licenseJurisdiction

Gets or sets the license plate jurisdiction/state/county.

 string

None.
wheelAlignmentRecommended

Indicates whether a wheel alignment is recommended (true) or not (false).

 boolean

None.
tireRotationRecommended

Indicates whether a tire rotation is recommended.

 boolean

None.
additionalRecommendations

Gets or sets the additional recommendations.

 Collection of string

None.
vehicleRemarks

Gets or sets the vehicle remarks.

 Collection of string

None.
odometerKm

Indicates the odometer value in kilometers.

 integer

None.
vehicleInfo

Gets or sets the vehicle information.

 TireScanVehicle_V2

None.
ownerInfo

Gets or sets the owner information.

 TireScanContactInfo_V2

None.
wheels

Gets or sets the Wheels information.

 Collection of TireScanWheel

None.
files

Gets or sets the files attached to the tire scan.

 Collection of TireScanFile_V2

None.
notes

Gets or sets the tire scan notes.

 Collection of string

None.
storageCardId

Storage card id if provided by the scanner equipment

 globally unique identifier

None.
equipmentSetId

Equipment set id if provided by the scanner equipment

 globally unique identifier

None.
wash

Gets or sets the wash state

 boolean

None.
washedDateTime

Gets or sets the wash date time

 date

None.

Remarks

Use api/tirescanner to add a tire scan.

Example

//Adds the specified tire scan. A tire scan object is needed in JSON format in the body of the request.
http://localhost/api/tirescanV2

Request Formats

application/json, text/json

Sample: 
{
  "brakingDistanceInPercent": 1.0,
  "branchId": 1,
  "correlationId": "77d6465f-2fd1-4e67-87c8-b9fbad1cab4a",
  "scanDateTime": "12/21/2025 1:06:15 PM",
  "scannerBrand": "sample string 3",
  "scannerType": "sample string 4",
  "scannerId": "sample string 5",
  "scannerFallbackDisplayName": "sample string 6",
  "season": "Summer",
  "licensePlate": "sample string 7",
  "licenseJurisdiction": "sample string 8",
  "wheelAlignmentRecommended": true,
  "tireRotationRecommended": true,
  "additionalRecommendations": [
    "sample string 1",
    "sample string 2"
  ],
  "vehicleRemarks": [
    "sample string 1",
    "sample string 2"
  ],
  "odometerKm": 1,
  "vehicleInfo": {
    "vin": "sample string 1",
    "modelYear": 2,
    "make": "sample string 3",
    "model": "sample string 4",
    "trim": "sample string 5",
    "bodyType": "sample string 6",
    "vehicleType": "sample string 7",
    "frontTireSize": "sample string 8",
    "rearTireSize": "sample string 9"
  },
  "ownerInfo": {
    "name": "sample string 1",
    "email": "sample string 2",
    "phoneNumber": "sample string 3"
  },
  "wheels": [
    {
      "positionAxle": "sample string 1",
      "positionIndex": 2,
      "tirePosition": 3,
      "rim": {
        "damage": true,
        "hubCap": true,
        "files": [
          {
            "fileUse": "sample string 1",
            "mimeType": "sample string 2",
            "data": "QEA="
          },
          {
            "fileUse": "sample string 1",
            "mimeType": "sample string 2",
            "data": "QEA="
          }
        ]
      },
      "tire": {
        "maxTreadDepthMm": 1.0,
        "maxTreadDepthsMm": [
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          },
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          }
        ],
        "minTreadDepthMm": 1.0,
        "minTreadDepthsMm": [
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          },
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          }
        ],
        "avgTreadDepthMm": 1.0,
        "avgTreadDepthsMm": [
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          },
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          }
        ],
        "recommendation": "sample string 1",
        "tireRemarks": [
          "sample string 1",
          "sample string 2"
        ],
        "files": [
          {
            "fileUse": "sample string 1",
            "mimeType": "sample string 2",
            "data": "QEA="
          },
          {
            "fileUse": "sample string 1",
            "mimeType": "sample string 2",
            "data": "QEA="
          }
        ],
        "notes": "sample string 2",
        "tireSize": "sample string 3",
        "tirePressure": 4.0,
        "tirePressureUnit": "sample string 5",
        "tin": "sample string 6",
        "load": "sample string 7",
        "dotMfgDate": "sample string 8",
        "studs": true,
        "nitrogen": true,
        "damage": true,
        "brand": "sample string 9",
        "speedRatingKey": "sample string 10",
        "unevenWear": true,
        "treadPattern": "sample string 11"
      }
    },
    {
      "positionAxle": "sample string 1",
      "positionIndex": 2,
      "tirePosition": 3,
      "rim": {
        "damage": true,
        "hubCap": true,
        "files": [
          {
            "fileUse": "sample string 1",
            "mimeType": "sample string 2",
            "data": "QEA="
          },
          {
            "fileUse": "sample string 1",
            "mimeType": "sample string 2",
            "data": "QEA="
          }
        ]
      },
      "tire": {
        "maxTreadDepthMm": 1.0,
        "maxTreadDepthsMm": [
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          },
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          }
        ],
        "minTreadDepthMm": 1.0,
        "minTreadDepthsMm": [
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          },
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          }
        ],
        "avgTreadDepthMm": 1.0,
        "avgTreadDepthsMm": [
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          },
          {
            "PositionInPercentAcrossTire": 1.0,
            "ValueInMm": 1.1
          }
        ],
        "recommendation": "sample string 1",
        "tireRemarks": [
          "sample string 1",
          "sample string 2"
        ],
        "files": [
          {
            "fileUse": "sample string 1",
            "mimeType": "sample string 2",
            "data": "QEA="
          },
          {
            "fileUse": "sample string 1",
            "mimeType": "sample string 2",
            "data": "QEA="
          }
        ],
        "notes": "sample string 2",
        "tireSize": "sample string 3",
        "tirePressure": 4.0,
        "tirePressureUnit": "sample string 5",
        "tin": "sample string 6",
        "load": "sample string 7",
        "dotMfgDate": "sample string 8",
        "studs": true,
        "nitrogen": true,
        "damage": true,
        "brand": "sample string 9",
        "speedRatingKey": "sample string 10",
        "unevenWear": true,
        "treadPattern": "sample string 11"
      }
    }
  ],
  "files": [
    {
      "fileUse": "sample string 1",
      "mimeType": "sample string 2",
      "data": "QEA="
    },
    {
      "fileUse": "sample string 1",
      "mimeType": "sample string 2",
      "data": "QEA="
    }
  ],
  "notes": [
    "sample string 1",
    "sample string 2"
  ],
  "storageCardId": "9798382a-b2ea-460a-874e-b0cefbf45075",
  "equipmentSetId": "b115984f-3699-4cd0-bf76-c3e76ff9c5c4",
  "wash": true,
  "washedDateTime": "12/21/2025 1:06:15 PM"
}

application/xml, text/xml

Sample: 
<TireScanV2_0Data xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Compilator.DDAPI.DTO.TireScan.V2">
  <AdditionalRecommendations xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </AdditionalRecommendations>
  <BrakingDistanceInPercent>1</BrakingDistanceInPercent>
  <BranchId>1</BranchId>
  <CorrelationId>77d6465f-2fd1-4e67-87c8-b9fbad1cab4a</CorrelationId>
  <EquipmentSetId>b115984f-3699-4cd0-bf76-c3e76ff9c5c4</EquipmentSetId>
  <Files>
    <TireScanFile_V2>
      <Data>QEA=</Data>
      <FileUse>sample string 1</FileUse>
      <MimeType>sample string 2</MimeType>
    </TireScanFile_V2>
    <TireScanFile_V2>
      <Data>QEA=</Data>
      <FileUse>sample string 1</FileUse>
      <MimeType>sample string 2</MimeType>
    </TireScanFile_V2>
  </Files>
  <LicenseJurisdiction>sample string 8</LicenseJurisdiction>
  <LicensePlate>sample string 7</LicensePlate>
  <Notes xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </Notes>
  <OdometerKm>1</OdometerKm>
  <OwnerInfo>
    <Email>sample string 2</Email>
    <Name>sample string 1</Name>
    <PhoneNumber>sample string 3</PhoneNumber>
  </OwnerInfo>
  <ScanDateTime>2025-12-21T13:06:15.3242746+00:00</ScanDateTime>
  <ScannerBrand>sample string 3</ScannerBrand>
  <ScannerFallbackDisplayName>sample string 6</ScannerFallbackDisplayName>
  <ScannerId>sample string 5</ScannerId>
  <ScannerType>sample string 4</ScannerType>
  <Season>Summer</Season>
  <StorageCardId>9798382a-b2ea-460a-874e-b0cefbf45075</StorageCardId>
  <TireRotationRecommended>true</TireRotationRecommended>
  <VehicleInfo>
    <BodyType>sample string 6</BodyType>
    <FrontTireSize>sample string 8</FrontTireSize>
    <Make>sample string 3</Make>
    <Model>sample string 4</Model>
    <ModelYear>2</ModelYear>
    <RearTireSize>sample string 9</RearTireSize>
    <Trim>sample string 5</Trim>
    <VehicleType>sample string 7</VehicleType>
    <Vin>sample string 1</Vin>
  </VehicleInfo>
  <VehicleRemarks xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </VehicleRemarks>
  <Wash>true</Wash>
  <WashedDateTime>2025-12-21T13:06:15.339901+00:00</WashedDateTime>
  <WheelAlignmentRecommended>true</WheelAlignmentRecommended>
  <Wheels>
    <TireScanWheel>
      <PositionAxle>sample string 1</PositionAxle>
      <PositionIndex>2</PositionIndex>
      <Rim>
        <Damage>true</Damage>
        <Files>
          <TireScanFile_V2>
            <Data>QEA=</Data>
            <FileUse>sample string 1</FileUse>
            <MimeType>sample string 2</MimeType>
          </TireScanFile_V2>
          <TireScanFile_V2>
            <Data>QEA=</Data>
            <FileUse>sample string 1</FileUse>
            <MimeType>sample string 2</MimeType>
          </TireScanFile_V2>
        </Files>
        <HubCap>true</HubCap>
      </Rim>
      <Tire>
        <AvgTreadDepthMm>1</AvgTreadDepthMm>
        <AvgTreadDepthsMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
        </AvgTreadDepthsMm>
        <Brand>sample string 9</Brand>
        <Damage>true</Damage>
        <DotMfgDate>sample string 8</DotMfgDate>
        <Files>
          <TireScanFile_V2>
            <Data>QEA=</Data>
            <FileUse>sample string 1</FileUse>
            <MimeType>sample string 2</MimeType>
          </TireScanFile_V2>
          <TireScanFile_V2>
            <Data>QEA=</Data>
            <FileUse>sample string 1</FileUse>
            <MimeType>sample string 2</MimeType>
          </TireScanFile_V2>
        </Files>
        <Load>sample string 7</Load>
        <MaxTreadDepthMm>1</MaxTreadDepthMm>
        <MaxTreadDepthsMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
        </MaxTreadDepthsMm>
        <MinTreadDepthMm>1</MinTreadDepthMm>
        <MinTreadDepthsMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
        </MinTreadDepthsMm>
        <Nitrogen>true</Nitrogen>
        <Notes>sample string 2</Notes>
        <Recommendation>sample string 1</Recommendation>
        <SpeedRatingKey>sample string 10</SpeedRatingKey>
        <Studs>true</Studs>
        <Tin>sample string 6</Tin>
        <TirePressure>4</TirePressure>
        <TirePressureUnit>sample string 5</TirePressureUnit>
        <TireRemarks xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:string>sample string 1</d5p1:string>
          <d5p1:string>sample string 2</d5p1:string>
        </TireRemarks>
        <TireSize>sample string 3</TireSize>
        <TreadPattern>sample string 11</TreadPattern>
        <UnevenWear>true</UnevenWear>
      </Tire>
      <TirePosition>3</TirePosition>
    </TireScanWheel>
    <TireScanWheel>
      <PositionAxle>sample string 1</PositionAxle>
      <PositionIndex>2</PositionIndex>
      <Rim>
        <Damage>true</Damage>
        <Files>
          <TireScanFile_V2>
            <Data>QEA=</Data>
            <FileUse>sample string 1</FileUse>
            <MimeType>sample string 2</MimeType>
          </TireScanFile_V2>
          <TireScanFile_V2>
            <Data>QEA=</Data>
            <FileUse>sample string 1</FileUse>
            <MimeType>sample string 2</MimeType>
          </TireScanFile_V2>
        </Files>
        <HubCap>true</HubCap>
      </Rim>
      <Tire>
        <AvgTreadDepthMm>1</AvgTreadDepthMm>
        <AvgTreadDepthsMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
        </AvgTreadDepthsMm>
        <Brand>sample string 9</Brand>
        <Damage>true</Damage>
        <DotMfgDate>sample string 8</DotMfgDate>
        <Files>
          <TireScanFile_V2>
            <Data>QEA=</Data>
            <FileUse>sample string 1</FileUse>
            <MimeType>sample string 2</MimeType>
          </TireScanFile_V2>
          <TireScanFile_V2>
            <Data>QEA=</Data>
            <FileUse>sample string 1</FileUse>
            <MimeType>sample string 2</MimeType>
          </TireScanFile_V2>
        </Files>
        <Load>sample string 7</Load>
        <MaxTreadDepthMm>1</MaxTreadDepthMm>
        <MaxTreadDepthsMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
        </MaxTreadDepthsMm>
        <MinTreadDepthMm>1</MinTreadDepthMm>
        <MinTreadDepthsMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
          <DepthMeasurementMm>
            <PositionInPercentAcrossTire>1</PositionInPercentAcrossTire>
            <ValueInMm>1.1</ValueInMm>
          </DepthMeasurementMm>
        </MinTreadDepthsMm>
        <Nitrogen>true</Nitrogen>
        <Notes>sample string 2</Notes>
        <Recommendation>sample string 1</Recommendation>
        <SpeedRatingKey>sample string 10</SpeedRatingKey>
        <Studs>true</Studs>
        <Tin>sample string 6</Tin>
        <TirePressure>4</TirePressure>
        <TirePressureUnit>sample string 5</TirePressureUnit>
        <TireRemarks xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:string>sample string 1</d5p1:string>
          <d5p1:string>sample string 2</d5p1:string>
        </TireRemarks>
        <TireSize>sample string 3</TireSize>
        <TreadPattern>sample string 11</TreadPattern>
        <UnevenWear>true</UnevenWear>
      </Tire>
      <TirePosition>3</TirePosition>
    </TireScanWheel>
  </Wheels>
</TireScanV2_0Data>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'TireScanV2_0Data'.

Response Information

Resource Description

The result of the operation as standard http web api status codes.

IHttpActionResult

None.

Response Formats

application/json, text/json, application/xml, text/xml

Sample:

Sample not available.