# Solicitar Relatório / Histórico

Este endpoint retorna um **protocolo único**, que pode ser utilizado para realizar consultas detalhadas no endpoint [/v2/consultarProtocolo](/relatorios/consultar-relatorio-historico.md). A partir desse protocolo, você poderá obter os dados da consulta no formato **JSON** para manipulação em seu sistema ou diretamente em **PDF**, pronto para download e compartilhamento.

> PDF também podem ser gerado já com identidade visual da sua marca (cor, logo e seu site). para isso necessário previamente se habilitar como revendedor junto a nossa equipe.

<mark style="color:green;">`POST`</mark> `https://api.consultarplaca.com.br/v2/solicitarRelatorio`

#### Request Body&#x20;

{% hint style="info" %}
&#x20;**Importante:** As requisições `POST` devem utilizar o `Content-Type: multipart/form-data`.\
Certifique-se de enviar os parâmetros no corpo da requisição como `form-data`.
{% endhint %}

<table><thead><tr><th width="222">Nome</th><th width="100">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>placa</td><td>string</td><td>Placa do Veículo.<br>Placa deve possuir os seguintes formatos: AAA9999 ou AAA9A99</td></tr><tr><td>tipo_consulta</td><td>string</td><td>Tipo da consulta. Valores possíveis:<br>- <mark style="color:blue;"><strong>bronze</strong></mark><br>- <mark style="color:blue;"><strong>prata</strong></mark><br>- <mark style="color:blue;"><strong>ouro</strong></mark><br>- <mark style="color:blue;"><strong>diamante</strong></mark><br>- <mark style="color:blue;"><strong>personalizada</strong></mark> <br><br><em>Para opção <strong>personalizada</strong> o campo informacoes_adicionais é obrigatório.</em></td></tr><tr><td>url_notificacao</td><td>string</td><td>URL para onde será enviado a notificação quando a consulta estiver pronta. Quando enviado este parâmetro assim que finalizado o processamento do relatório uma notificação <strong>POST</strong> será enviada com um formato <strong>JSON</strong> conforme exemplo abaixo:<br><code>{</code><br>  <code>"protocolo":"ABCDEF",</code><br>  <code>"dados":{</code><br>    <code>"url_pdf":"http://app.consultarpla...."</code><br>  <code>}</code><br><code>}</code></td></tr><tr><td>consulta_para_revenda</td><td>boolean</td><td>Identificação se o relatório deve ou não ser gerado no formato de revenda. <br><mark style="color:blue;"><strong>1</strong></mark> para <strong>SIM</strong>. Neste caso o relatório será gerado com a logo, cor e endereço do site do revendedor.<br><mark style="color:blue;"><strong>0</strong></mark> para <strong>NÃO</strong>. Neste caso o relatório é gerado com a identidade visual do <strong>Consultar Placa</strong>.<br><br>O valor padrão deste campo é 0 (NÃO). <br><em>* Para gerar relatório como revenda é necessário credenciar sua conta junto a nossa equipe.</em></td></tr><tr><td>informacoes_adicionais</td><td>String</td><td><p>Informações adicionais que devem ser inclusas no relatório. Para mais de um adicional passar os valores separados por vírgula. (Ex: <strong>3, 4, 1</strong>). Valores Possíveis:<br><mark style="color:blue;"><strong>1</strong></mark> = Informações sobre a ocorrência de sinistros com Perda Total (PT)</p><p><mark style="color:blue;">3</mark> = Registro de Ofertas em Leilões PRIME (Verifica leilões Corporativo, Privado e Varejo ) </p><p><mark style="color:blue;"><strong>4</strong></mark> = Histórico de Roubo e Furto</p><p><mark style="color:blue;"><strong>5</strong></mark> = Verificação junto a Base Federal (DENATRAN) sobre Restrições Financeiras e Judiciais (RENAJUD) <br><mark style="color:blue;"><strong>7</strong></mark> = Verificação junto a Base Estadual <br>(DETRANS) como <strong>Renavam</strong> e Restrições)</p><p><mark style="color:blue;"><strong>8</strong></mark><strong> =</strong> Informações gerais sobre o veículo (Chassi, Marca/Modelo, Ano Modelo ...)</p><p><mark style="color:$primary;"><strong>10</strong></mark> = GRAVAME (Alienação Financeira)</p><p><mark style="color:blue;"><strong>13</strong></mark> = Registro de Ofertas em Leilões Simples (NÃO verifica Leilões Corporativo, Privado e Varejo ) <br><mark style="color:blue;"><strong>17</strong></mark> = Verificação junto ao Registro Nacional de Infrações de Trânsito (RENAINF)</p><p><mark style="color:blue;"><strong>18</strong></mark> = Recall</p><p><mark style="color:blue;"><strong>19</strong></mark> = Guia de Imagens (NÃO necessariamente imagens do veículo consultado)</p><p><mark style="color:blue;"><strong>23</strong></mark> = Ficha Técnica Comparativa<br><mark style="color:blue;"><strong>24</strong></mark> = Custo Médio de Manutenção<br><mark style="color:blue;"><strong>25</strong></mark> = Proprietário atual do veículo (Exibe apenas o primeiro nome e os dígitos iniciais do documento, sem identificar a pessoa).</p><p><mark style="color:$primary;"><strong>27</strong></mark> = Referência de Preço (Fipe)</p><p></p><p><em>Caso seja enviado algum adicional inválido, ou que já esteja contido no tipo de consulta solicitado o mesmo será ignorado.</em></p><p></p></td></tr></tbody></table>

#### Exemplos de respostas

<mark style="color:green;">200</mark> - Consulta solicitada com sucesso

```json
{
    "status": "ok",
    "mensagem": "Consulta solicitada com sucesso!",
    "data_solicitacao": "2019-08-25 16:51:24",
    "protocolo": "XXXXXXXXXXXXXXX",
    "link_resultado": "https://api.consultarplaca.com.br/v2/consultarProtocolo?protocolo=XXXXXXXXXXXXXXX",
    "request": [
        "placa": "AAA9999",
        "tipo_consulta": "basica"
    ]
}
```


---

# 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://docs.consultarplaca.com.br/relatorios/solicitar-relatorio-historico.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.