# Solicitar Relatório / Histórico

Este endpoint retorna um **protocolo único**, que pode ser utilizado para realizar consultas detalhadas no endpoint [/v2/consultarProtocolo](https://docs.consultarplaca.com.br/relatorios/consultar-relatorio-historico). 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><br><mark style="color:blue;">3</mark> = Registro de Ofertas em Leilões PRIME (Verifica leilões Corporativo, Privado e Varejo )<br><br><mark style="color:blue;"><strong>4</strong></mark> = Histórico de Roubo e Furto</p><p><br><mark style="color:blue;"><strong>5</strong></mark> = Verificação junto a Base Federal (DENATRAN) sobre Restrições Financeiras e Judiciais (RENAJUD)</p><p><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></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><br><mark style="color:blue;"><strong>12</strong></mark> = Referência de Preço (Fipe / Precificador)</p><p></p><p><mark style="color:blue;">13</mark> = Registro de Ofertas em Leilões Simples (NÃO verifica Leilões Corporativo, Privado e Varejo )<br><br><mark style="color:blue;"><strong>17</strong></mark> = Verificação junto ao Registro Nacional de Infrações de Trânsito (RENAINF)</p><p></p><p><mark style="color:blue;"><strong>18</strong></mark> = Recall<br></p><p><mark style="color:blue;"><strong>19</strong></mark> = Guia de Imagens (NÃO necessariamente imagens do veículo consultado)<br></p><p><mark style="color:blue;"><strong>23</strong></mark> = Ficha Técnica Comparativa<br><br><mark style="color:blue;"><strong>24</strong></mark> = Custo Médio de Manutenção<br><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></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"
    ]
}
```