# Car Analysis

AutoGrab can service PDF reports over API that can then be handled in your application.

{% openapi src="<https://1154811857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUypmYo5OBsuC4nJIUOZk%2Fuploads%2FO1mxxRIRpDcKC6fr56tG%2Fswagger_fixed_final.json?alt=media&token=956f728c-69a3-4540-b468-70d8d8e1068d>" path="/v2/reports/car-analysis" method="post" %}
[swagger\_fixed\_final.json](https://1154811857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUypmYo5OBsuC4nJIUOZk%2Fuploads%2FO1mxxRIRpDcKC6fr56tG%2Fswagger_fixed_final.json?alt=media\&token=956f728c-69a3-4540-b468-70d8d8e1068d)
{% endopenapi %}

## Report Features

The report endpoint has the ability to determine the content of the report based on the information that is handed to it.

### Vehicle Identification

The CarAnalysis report contains a stock photo and vehicle-specific information. This is generated using the VIN or Registration and State. Provide all three wherever possible to obtain the most accurate information possible for report generation.

### Valuation

A valuation can be included in the report generation by adding the following data. What data is used for the valuation is determined on priority:

#### Price Record ID

If the pricing record ID is passed in the request, the associated valuation will populate the report. A valuation ID is generated using the [valuation](https://devhub.autograb.com/my-autograb-api-doc/valuation "mention") endpoint and contained in the response. So, a valuation call needs to be performed before generating the report.

#### Lead ID

A lead ID is obtained from the [sourcing](https://devhub.autograb.com/my-autograb-api-doc/sourcing "mention") endpoint and is the tier 2 valuation source.

#### Odometer

If no Pricing or Lead ID is provided but an odometer is, the odometer will be used to perform a valuation with the same logic as the [valuation](https://devhub.autograb.com/my-autograb-api-doc/valuation "mention") endpoint.

### Sources

{% hint style="info" %}
What sources are available with your account are controlled at a feature level. To access particular sources, don't hesitate to get in touch with your AutoGrab representative.
{% endhint %}

The sources enum determines additional features that are included within the report PDF.

#### PPSR

A PPSR report provided by the government will be attached to the end of the PDF

#### Vehicle Details

Populates the Vehicle Information at the top of the report. It is recommended that vehicle details always be included as it contains the minimum identifiable information into the report.

#### Odometer History

It will display a table of all recorded odometer listings that AutoGrab has. Based on the odometer from previous listings, it can highlight the possibility of odometer rollback events.

#### Build Date

It will populate a table with built-data information, which is the same data obtainable from the [factory-build-data](https://devhub.autograb.com/my-autograb-api-doc/vehicle-data/factory-build-data "mention")endpoint in PDF format.

#### Fitted Options

Not currently implemented

## Report White Labeling

AutoGrab can create custom-branded templates for the Car Analysis report. Please reach out to your AutoGrab representative for more information on building a custom template.

{% openapi src="<https://1154811857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUypmYo5OBsuC4nJIUOZk%2Fuploads%2FO1mxxRIRpDcKC6fr56tG%2Fswagger_fixed_final.json?alt=media&token=956f728c-69a3-4540-b468-70d8d8e1068d>" path="/v2/reports/car-analysis/{id}" method="get" %}
[swagger\_fixed\_final.json](https://1154811857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUypmYo5OBsuC4nJIUOZk%2Fuploads%2FO1mxxRIRpDcKC6fr56tG%2Fswagger_fixed_final.json?alt=media\&token=956f728c-69a3-4540-b468-70d8d8e1068d)
{% endopenapi %}

## Obtaining Generated Reports

Due to the Car Analysis report reaching out to external endpoints and co-lating data the report is not generated immediately. It is recommended that the ID for the report be stored for future use or that the PDF be obtained again later.

To obtain the requested report, pass the ID from the POST to the get endpoint.

{% hint style="warning" %}
It is highly recommended that you delay the Get by at least 20 seconds before attempting the request to allow sufficient time for the report to be generated.
{% endhint %}

## Example Report

{% file src="<https://content.gitbook.com/content/UypmYo5OBsuC4nJIUOZk/blobs/XyHhkjN7AdkutKZSiUFK/Standard%20Car%20Analysis.pdf>" %}
