# Certificates

{% hint style="danger" %}
The certificate's endpoint is officially deprecated in favour of the[ Car Analysis ](/my-autograb-api-doc/reports/car-analysis.md)endpoint for the purpose of generating Car Analysis Reports

The documentation on this page is for historical reference only and should not be used for any integration development.
{% endhint %}

AutoGrab can provide valuation and vehicle info certificates for you to offer through your own products in Australia. To request a certificate use the v2/certificates/generate endpoint and pass in the [Valuation ID](/my-autograb-api-doc/valuation/valuation-basics.md), that you have previously run as well as the type of certificate you'd like

### CarAnalysis

#### **Standard CarAnalysis**

For a standard CarAnalysis certificate, you can submit a request as below to receive the payload with summary info as well as the URL of the pdf. This certificate does include a PPSR report. 

```postman_json
{
  "valuation_id": "8c7c62c4-f41b-48f6-8b18-bb09851cd0fe",
  "type": "car-analysis"
}
```

An example response is below. 

```json
{
    "success": true,
    "certificate": {
        "id": "ef1798ec-e34b-456a-b0d6-16f873071b7a",
        "vin": "WVWZZZAWZKU065305",
        "rego": "BMT038",
        "rego_state": "VIC",
        "url": "https://storage.googleapis.com/ag-ppsr/ef1798ec-e34b-456a-b0d6-16f873071b7a/report.pdf",
        "certificate_created_at": "2023-11-21T09:12:39.000Z",
        "year": "2019",
        "make": "VOLKS",
        "model": "POLO",
        "body_type": "CAR/SEDAN",
        "colour": "WHITE",
        "has_safety_recalls": false,
        "has_secured_parties": true,
        "has_stolen_records": false,
        "has_written_off_records": false
    }
}
```

If you wish to view an example CarAnalysis including PPSR you can find one below.

{% file src="/files/HXLqGS9J5AMahdbr7sLe" %}

#### **CarAnalysis Without Valuation**

There may be user experiences where you do not wish to show a valuation on your certificates. You can use `car-analysis` as the type to request this. The response you will receive will be the same as above but the PDF will not have a valuation present. 

```postman_json
{
  "type": "car-analysis",
  "vin": "WVWZZZAWZKU065305"
}
```

If you wish to view an example CarAnalysis excluding a Valuation you can find one below.

{% file src="/files/Zk1mwP08Eou8fO5A6h7S" %}

#### Car Analysis Standalone

This is a CarAnalysis report without a PPSR or Valuation. To request this certificate type use car-analysis-standalone. 

```postman_json
{
  "type": "car-analysis-standalone",
  "vin": "WVWZZZAWZKU065305"
}
```

An example response is below

```json
{
    "success": true,
    "certificate": {
        "vin": "WVWZZZAWZKU065305",
        "url": "https://storage.googleapis.com/ag-pdf/1700518730355/report.pdf",
        "certificate_created_at": "2023-11-20T22:18:50.822Z"
    }
}
```

If you wish to view an example CarAnalysis Standalone you can find one below.

{% file src="/files/SRLeXxVMWm7MOsy9QR5q" %}

## White Label

We offer white-label of certificates and can configure them to your brand guidelines. Contact us to learn more about the commercial arrangements. Technically you would just need to include a brand parameter in your request body.

```json
{
  "valuation_id": "098a0653-ae84-4a97-a2d8-505896ce3229",
  "type": "car-analysis-standalone",
  "brand": "caranalysis"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://devhub.autograb.com/my-autograb-api-doc/reports/certificates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.