# Consultar Relatório / Histórico

<mark style="color:blue;">`GET`</mark> `https://api.consultarplaca.com.br/v2/consultarProtocolo`

Retorna o resultado da consulta de uma placa previamente registrada através da rota [/v2/solicitarRelatorio](/relatorios/solicitar-relatorio-historico.md)**.** Os dados podem ser solicitados nos formatos de PDF ou JSON.

#### Parâmetros

<table><thead><tr><th width="217">Nome</th><th width="142">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>protocolo<mark style="color:red;">*</mark></td><td>string</td><td>Protocolo retornado no momento do registro da consulta (Rota <a href="/pages/StkS2JYD01cpLkW7135G">/v2/solicitarRelatorio</a>)</td></tr><tr><td>tipo_retorno</td><td>string</td><td>Formato que os dados serão retornados. Valores possíveis:<br>- PDF<br>- JSON<br><br>Caso o tipo do retorno não seja informado o formato padrão será o de PDF<br></td></tr></tbody></table>

#### Exemplos de respostas

Requisição realizada com sucesso. \
Situação de uma consulta (campo **situacao\_consulta**) pode possuir o seguintes valores:&#x20;

* <mark style="color:blue;">**em\_processamento**</mark>: Processamento dos dados ainda não está finalizado.
* <mark style="color:blue;">**parcialmente\_finalizada**</mark>: Uma versão parcial está disponível. Situação ocorre quando alguma informação ainda não foi disponibilizada.&#x20;
* <mark style="color:blue;">**finalizada**</mark>: Consulta finaliza e disponível para download.

```json
// Exemplo em processamento
{
    "status": "ok",
    "mensagem": "Consulta em processamento.",
    "situacao_consulta": "em_processamento",
    "sobre_os_dados": "As informações retornadas nesta consulta, visam exclusivamente COLABORAR com o processo de averiguação de procedência do veículo, servindo apenas como uma ferramenta de ANÁLISE PRÉVIA e não como elemento de decisão para comercialização do veículo. As informações retornadas nesta pesquisa são as que se encontram disponíveis na data e hora da consulta às bases, sites e pacotes de dados ora contratados e somente será utiliza único e exclusivamente por mim CONTRATANTE sabendo que estou vedado da divulgação da mesma para terceiros, e isento o Consultar Placa de toda e qualquer responsabilidade caso haja divergência de informação, informo ainda que utilizo a consulta para fins estatísticos e tenho conhecimento que existem casos de não informado e divergências em relação às bases on-lines, podendo os registros serem apagados ou apresentarem divergências ou ainda possuírem informações incompletas ou excluídas, como por exemplo apontamentos de registros de leilão, sinistro e demais informações históricas, que podem ser alteradas, baixadas, excluídas e/ou não informadas.",    
    "dados": [],
    "request": {
        "protocolo": "ABCDEFG"
    }
}
```

```json
// Exemplo de retorno parcialmente_finalizado (Tipo retorno PDF)
{
    "status": "ok",
    "mensagem": "Consulta realizada com sucesso.",
    "situacao_consulta": "parcialmente_finalizada",
    "protocolo": "ABCDEFG",
    "sobre_os_dados": "As informações retornadas nesta consulta, visam exclusivamente COLABORAR com o processo de averiguação de procedência do veículo, servindo apenas como uma ferramenta de ANÁLISE PRÉVIA e não como elemento de decisão para comercialização do veículo. As informações retornadas nesta pesquisa são as que se encontram disponíveis na data e hora da consulta às bases, sites e pacotes de dados ora contratados e somente será utiliza único e exclusivamente por mim CONTRATANTE sabendo que estou vedado da divulgação da mesma para terceiros, e isento o Consultar Placa de toda e qualquer responsabilidade caso haja divergência de informação, informo ainda que utilizo a consulta para fins estatísticos e tenho conhecimento que existem casos de não informado e divergências em relação às bases on-lines, podendo os registros serem apagados ou apresentarem divergências ou ainda possuírem informações incompletas ou excluídas, como por exemplo apontamentos de registros de leilão, sinistro e demais informações históricas, que podem ser alteradas, baixadas, excluídas e/ou não informadas.",
    "dados": {
        "url_pdf": "https://app.consultarplaca.com.br/cp/d/XXXXXXXXXXXXX"
    },
    "request": {
        "protocolo": "ABCDEFG"
    }
}
```

```json
// Exemplo de retorno finalizado (Tipo retorno PDF)
{
    "status": "ok",
    "mensagem": "Consulta realizada com sucesso.",
    "situacao_consulta": "finalizada",
    "protocolo": "ABCDEFG",
    "sobre_os_dados": "As informações retornadas nesta consulta, visam exclusivamente COLABORAR com o processo de averiguação de procedência do veículo, servindo apenas como uma ferramenta de ANÁLISE PRÉVIA e não como elemento de decisão para comercialização do veículo. As informações retornadas nesta pesquisa são as que se encontram disponíveis na data e hora da consulta às bases, sites e pacotes de dados ora contratados e somente será utiliza único e exclusivamente por mim CONTRATANTE sabendo que estou vedado da divulgação da mesma para terceiros, e isento o Consultar Placa de toda e qualquer responsabilidade caso haja divergência de informação, informo ainda que utilizo a consulta para fins estatísticos e tenho conhecimento que existem casos de não informado e divergências em relação às bases on-lines, podendo os registros serem apagados ou apresentarem divergências ou ainda possuírem informações incompletas ou excluídas, como por exemplo apontamentos de registros de leilão, sinistro e demais informações históricas, que podem ser alteradas, baixadas, excluídas e/ou não informadas.",
    "dados": {
        "url_pdf": "https://app.consultarplaca.com.br/cp/d/XXXXXXXXXXXXX"
    },
    "request": {
        "protocolo": "ABCDEFG"
    }
}
```

No exemplo abaixo são apresentadas todas as informações disponíveis nos relatórios Diamante, demais relatórios retornarão apenas informações cobertas pelos modelos em questão.  Veja [aqui](https://www.consultarplaca.com.br/#precos) a diferença entre os relatórios.&#x20;

```json
{
    "status": "ok",
    "mensagem": "Consulta realizada com sucesso.",
    "situacao_consulta": "finalizada",
    "protocolo": "xxxxxxxxxxxx",
    "sobre_os_dados": "As informações retornadas nesta consulta, visam exclusivamente COLABORAR com o processo de averiguação de procedência do veículo, servindo apenas como uma ferramenta de ANÁLISE PRÉVIA e não como elemento de decisão para comercialização do veículo. As informações retornadas nesta pesquisa são as que se encontram disponíveis na data e hora da consulta às bases, sites e pacotes de dados ora contratados e somente será utiliza único e exclusivamente por mim CONTRATANTE sabendo que estou vedado da divulgação da mesma para terceiros, e isento o Consultar Placa de toda e qualquer responsabilidade caso haja divergência de informação, informo ainda que utilizo a consulta para fins estatísticos e tenho conhecimento que existem casos de não informado e divergências em relação às bases on-lines, podendo os registros serem apagados ou apresentarem divergências ou ainda possuírem informações incompletas ou excluídas, como por exemplo apontamentos de registros de leilão, sinistro e demais informações históricas, que podem ser alteradas, baixadas, excluídas e/ou não informadas.",
    "dados": [
        /* Informações gerais (Chassi, N° Motor, Marca, Modelo e Ano) */
        {
            "informacoes_veiculo": {
                "dados_veiculo": {
                    "placa": "AAA9999",
                    "chassi": "9AAAA99A1AA999999",
                    "ano_fabricacao": "2014",
                    "ano_modelo": "2014",
                    "marca": "VW",
                    "modelo": "NOVA SAVEIRO CE CROSS",
                    "cor": "PRETA",
                    "segmento": "Comercial Leve",
                    "combustivel": "ALCOOL/GASOLINA",
                    "procedencia": "NACIONAL",
                    "municipio": "GOIANIA",
                    "uf_municipio": "GO"
                },
                "dados_tecnicos": {
                    "tipo_veiculo": "CAMINHONETE",
                    "sub_segmento": "CL - PICK-UP PEQUENA",
                    "numero_motor": "CCRR75774",
                    "numero_caixa_cambio": null,
                    "potencia": "104",
                    "cilindradas": "1598"
                },
                "dados_carga": {
                    "numero_eixos": "2",
                    "capacidade_maxima_tracao": "213",
                    "capacidade_passageiro": "2",
                    "peso_bruto_total": "173"
                }
            }
        },
        /* Registro de Ofertas em Leilões Prime (Com Classificação) */
        {
            "informacoes_sobre_leilao": {
                "possui_registro": "sim",
                "registro_sobre_oferta": {
                    "classificacao": "D",
                    "dicionario_classificacoes": {
                        "A": {
                            "titulo": "Sem Avarias",
                            "descricao": "Veículos com boa lataria e mecânica funcionando no ato do leilão, os principais motivos destes leilões são:\nVeículos recuperados de financiamento onde o comprador não conseguiu pagar todo o financiamento e entregou o carro para o Banco como parte da garantia.\nVeiculos de empresas particulares a empresa leiloa o veículo antigo por um preço menor que o mercado para fazer dinheiro mais rápido.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo."
                        },
                        "B": {
                            "titulo": "Avarias leves",
                            "descricao": "Veículos com lataria danificada até 2 peças como para-lamas, farol, vidros, entre outros, mecânica funcionando no ato do leilão, os principais motivos destes leilões são:\nVeículos recuperados de financiamento onde o comprador não conseguiu pagar todo o financiamento e entregou o carro para o Banco como parte da garantia.\nVeiculos de empresas particulares a empresa leiloa o veículo antigo por um preço menor que o mercado para fazer dinheiro mais rápido.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo."
                        },
                        "C": {
                            "titulo": "Avarias médias",
                            "descricao": "Veículos com lataria danificada acima de 2 peças como para-lamas, farol, vidros e mecânica funcionando em alguns casos no ato do leilão, os principais motivos destes leilões são:\nVeículos que sofreram uma (batida, choque, quebra, outro prejuízo material) onde o conserto do veículo foi superior a 75% do valor do veículo de acordo com a seguradora onde a seguradora está vendendo para repor parte do dinheiro que ela pagou ao segurado.\nVeículos recuperados de Roubo e Furto onde a seguradora já indenizou o segurado vão para leilão para seguradora repor parte do dinheiro que pagou para o segurado.\nVeículos penhorados pela Justiça para execução de penas, por exemplo, alguém que não pagou o IPVA e o carro foi apreendido pela polícia para ser leiloado e a dívida quitada com o governo."
                        },
                        "D": {
                            "titulo": "Avarias graves",
                            "descricao": "Veículos com lataria danificada onde não foi possível  estimar com precisão quais os danos que o veículo sofreu e mecânica não funcionando no ato do leilão os principais motivos destes leilões são:\nVeículos que sofreram uma (batida, choque, quebra, outro prejuízo material) onde o conserto do veículo foi superior a 75% do valor do veículo de acordo com a seguradora onde a seguradora está vendendo para repor parte do dinheiro que ela pagou ao segurado.\nVeículos recuperados de Roubo e Furto onde a seguradora já indenizou o segurado vão para leilão para seguradora repor parte do dinheiro que pagou para o segurado."
                        }
                    }
                },
                "registro_leiloes": {
                    "registros": [
						{
                            "lote": "9999",
                            "data_leilao": "04/08/2014",
                            "placa": "AAA9999",
                            "classi": "9AAAA99A1AA999999",
                            "renavam": "",
                            "ano_fabricacao": "2014",
                            "ano_modelo": "",
                            "segmento": "",
                            "sub_segmento": "",
                            "numero_motor": ""
                        }
					]
                },
                "registro_sinistros_acidentes": {
                    "possui_registro": "nao"
                }
            }
        },
        /* Histórico de Roubo e Furto */
        {
            "historico_roubo_furto": {
                "registros_roubo_furto": {
                    "possui_registro": "sim",
                    "registros": [
                        {
                            "boletim_ocorrencia": "4389",
                            "data_boletim_ocorrencia": "28/07/2007",
                            "tipo_ocorrencia": "Declaração de Roubo/Furto",
                            "uf_ocorrencia": "GO"
                        },
                        {
                            "boletim_ocorrencia": "9812",
                            "data_boletim_ocorrencia": "02/08/2007",
                            "tipo_ocorrencia": "Achado",
                            "uf_ocorrencia": "GO"
                        },
                        {
                            "boletim_ocorrencia": "95249",
                            "data_boletim_ocorrencia": "13/08/2007",
                            "tipo_ocorrencia": "Devolvido",
                            "uf_ocorrencia": "GO"
                        }
                    ]
                }
            }
        },
        /* Verificação junto a Base Estadual (DETRANS) como Renavam e Restrições */
        {
            "informacoes_do_detran": {
                "numero_renavam": "99999999999",
                "restricoes_detran": {
                    "situacao_veiculo": "CIRCULACAO",
                    "remarcacao_chassi": "NORMAL",
                    "restricao_furto": {
                        "possui_restricao": "nao",
                        "restricao": "NADA CONSTA",
                        "descricao": ""
                    },
                    "restricao_guincho": {
                        "possui_restricao": "nao",
                        "restricao": "NADA CONSTA",
                        "descricao": ""
                    },
                    "restricao_administrativa": {
                        "possui_restricao": "nao",
                        "restricao": "NADA CONSTA",
                        "descricao": ""
                    },
                    "restricao_judicial": {
                        "possui_restricao": "nao",
                        "restricao": "NADA CONSTA",
                        "descricao": ""
                    },
                    "restricao_tributaria": {
                        "possui_restricao": "nao",
                        "restricao": "NADA CONSTA",
                        "descricao": ""
                    },
                    "restricao_judicial_renajud": {
                        "possui_restricao": "nao",
                        "restricao": "NADA CONSTA",
                        "descricao": ""
                    },
                    "outras_restricoes": {
                        "possui_restricao": "nao",
                        "restricoes": []
                    },
                    "comunicacao_venda": {
                        "possui_comunicacao": "nao",
                        "comunicacao": "NADA CONSTA",
                        "descricao": ""
                    }
                },
                "debitos_detran": {
                    "debitos_ipva": {
                        "possui_debido": "sim",
                        "debido": "1.739,10"
                    },
                    "debitos_multa": {
                        "possui_debido": "sim",
                        "debido": "130,16"
                    },
                    "debitos_licenciamento": {
                        "possui_debido": "sim",
                        "debido": "239,22"
                    },
                    "debitos_dpvat": {
                        "possui_debido": "nao",
                        "debido": 0
                    },
                    "debitos_municipais": {
                        "possui_debido": "sim",
                        "debido": "130,16"
                    }
                },
                "informacoes_primeiro_faturamento": {
                    "tipo_documento_proprietario": "",
                    "tipo_documento_faturado": "JURIDICA",
                    "documento_faturado": "99999999999999",
                    "estado_faturado": "DF"
                }
            }
        },
        /* Verificação junto ao Registro Nacional de Infrações de Trânsito (RENAINF) */
        {
            "registro_debitos_por_infracoes_renainf": {
                "infracoes_renainf": {
                    "possui_infracoes": "sim",
                    "infracoes": [
                        {
                            "dados_infracao": {
                                "infracao": "6050 - AVANCAR SINAL VERMELHO DO SEMAFORO OU DE PARADA OBRIGATORIA",
                                "numero_auto_infracao": "R999999999",
                                "valor_aplicado": "293,47",
                                "orgao_autuador": "293730 - GOIANIA",
                                "tipo_auto_infracao": "Eletronico",
                                "local_infracao": "AV  85 X AV  T9 QD 61 LOTE 1 3",
                                "municipio": "GOIANIA"
                            },
                            "aplicacao": {
                                "unidade_medida": "*****",
                                "limite_permitido": "0,00",
                                "medicao_considerada": "0,00",
                                "medicao_real": "0,00"
                            },
                            "eventos": {
                                "data_hora_infracao": "09/01/2022 05:13",
                                "data_cadastramento": "28/01/2022",
                                "data_notificacao": "28/01/2022",
                                "data_emissao_penalidade": ""
                            }
                        },
                        {
                            "dados_infracao": {
                                "infracao": "6920 - NAO REGISTRAR VEICULO NO PRAZO DE 30 DIAS",
                                "numero_auto_infracao": "B999999999",
                                "valor_aplicado": "130,16",
                                "orgao_autuador": "109100 - DETRAN",
                                "tipo_auto_infracao": "Manual",
                                "local_infracao": "AV  ENG  ATILIO CORREA LIMA  N",
                                "municipio": "GOIANIA"
                            },
                            "aplicacao": {
                                "unidade_medida": "*****",
                                "limite_permitido": "0,00",
                                "medicao_considerada": "0,00",
                                "medicao_real": "0,00"
                            },
                            "eventos": {
                                "data_hora_infracao": "30/12/2021 10:28",
                                "data_cadastramento": "30/12/2021",
                                "data_notificacao": "31/12/2021",
                                "data_emissao_penalidade": "12/03/2022"
                            }
                        }
                    ]
                }
            }
        },
        /* Informações sobre a ocorrência de sinistros com Perda Total (PT) */
        {
            "registro_sinistro_com_perda_total": {
                "possui_registro": "nao",
                "registro": ""
            }
        },
        /* Verificação junto a Base Federal (DENATRAN) sobre Restrições Financeiras e Judiciais (RENAJUD) */
        {
            "registro_de_bloqueio_judicial_renajud": {
                "possui_bloqueio": "nao",
                "bloqueios": [
		    {
		        "tribunal": "TRF04",
			"judiciario": "RSSCR01",
			"processo": "99999999999999000000001",
			"tipo_restricao": "Transferencia de Propriedade"
    		    },
		    {
			"tribunal": "TJRS",
			"judiciario": "1A VARA CIVEL DE SANTA CRUZ DO SUL",
			"processo": "99999999999999000000002",
			"tipo_restricao": "Transferencia de Propriedade"
		    },
		    {
			"tribunal": "TJRS",
			"judiciario": "1A VARA CIVEL DE SANTA CRUZ DO SUL",
			"processo": "99999999999999000000003",
			"tipo_restricao": "Transferencia de Propriedade"
		    }
		]
            }
        },
        /* Referência de Preço (Fipe) */
        {
            "referencia_precificador": {
                "possui_registro": "sim",
                "decodificador_simplificado": {
                    "origem": "NACIONAL",
                    "local_fabricacao": "SAO BERNARDO DO CAMPO / SP",
                    "pais": "BRASIL",
                    "regiao": "BRASIL / PARAGUAI / COLOMBIA / URUGUAI",
                    "ano_modelo": "2014",
                    "categoria": "UTILITARIO"
                },
                "desvalorizacao": [
                    {
                        "codigo": "005315-5",
                        "data_ref_fipe": "JAN/2014",
                        "valor": "62413",
                        "valor_zero_km": "48973",
                        "combustivel": "G",
                        "marca": "VW - VolksWagen",
                        "modelo": "Saveiro CROSS 1.6 Mi Total Flex 8V CE",
                        "evolucao": [
                            {
                                "mes": "JUN/2021",
                                "valor": "48950"
                            },
                            {
                                "mes": "JUL/2021",
                                "valor": "50466"
                            },
                            {
                                "mes": "AGO/2021",
                                "valor": "52572"
                            },
                            {
                                "mes": "SET/2021",
                                "valor": "54201"
                            },
                            {
                                "mes": "OUT/2021",
                                "valor": "54888"
                            },
                            {
                                "mes": "NOV/2021",
                                "valor": "55936"
                            },
                            {
                                "mes": "DEZ/2021",
                                "valor": "57025"
                            },
                            {
                                "mes": "JAN/2022",
                                "valor": "59264"
                            },
                            {
                                "mes": "FEV/2022",
                                "valor": "59618"
                            },
                            {
                                "mes": "MAR/2022",
                                "valor": "59307"
                            },
                            {
                                "mes": "ABR/2022",
                                "valor": "61182"
                            },
                            {
                                "mes": "MAI/2022",
                                "valor": "62413"
                            }
                        ]
                    }
                ],
                "preco_medio": [
                    {
                        "versao": "CE CROSS G6 1.6 8V FLEX 101cv 2p Etanol/Gasolina 4x2 Mecânico Picape",
                        "valor": "58200"
                    },
                    {
                        "versao": "CE CITY G6 1.6 8V FLEX 101cv 2p Etanol/Gasolina 4x2 Mecânico Picape",
                        "valor": "46200"
                    },
                    {
                        "versao": "CE TROOPER G6 1.6 8V FLEX 101cv 2p Etanol/Gasolina 4x2 Mecânico Picape",
                        "valor": "55000"
                    }
                ]
            }
        },
        /* Histórico Recall */
        {
            "possui_recall": "sim",
            "registros": [
                {
                    "data_inicio_campanha": "21/01/2019",
                    "montadora": "VOLKSWAGEN",
                    "sistema_ou_peca": "",
                    "defeito": "",
                    "gravidade": {
                        "indicador": "3",
                        "descricao": "Grande Importancia, Essencial, Emergencial"
                    }
                }
            ]
        },
        /* Guia de Imagens */
        {   
            "possui_imagens": "sim",
            "imagens": [
                {
                    "descricao": "Veiculo Frente",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p1-830248457.jpg",
                    "observacao": ""
                },
                {
                    "descricao": "Veiculo Traseira",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p2-733311311.jpg",
                    "observacao": ""
                },
                {
                    "descricao": "Morfologia Nr Chassi 1",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p3-192580190.jpg",
                    "observacao": ""
                },
                {
                    "descricao": "Indicacao Nr Chassi 1",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p4-583659017.jpg",
                    "observacao": "Assoalho Direito (a frente do banco do passageiro dianteiro)"
                },
                {
                    "descricao": "Morfologia Nr Motor",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p7-122084130.jpg",
                    "observacao": ""
                },
                {
                    "descricao": "Indicacao Nr Motor",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p8-674204724.jpg",
                    "observacao": "Parte posterior do bloco, entre a juncao do cambio e a do cabecote"
                },
                {
                    "descricao": "Etiquetas destrutiveis",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p9-735276560.jpg",
                    "observacao": ""
                },
                {
                    "descricao": "Morfologia Gravacao Vidros",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p10-188333666.jpg",
                    "observacao": ""
                },
                {
                    "descricao": "Morfologia Nr Cambio",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p14-782304672.jpg",
                    "observacao": ""
                },
                {
                    "descricao": "Indicacao Nr Cambio",
                    "imagem": "https://s3-sa-east-1.amazonaws.com/img/11779114-c1583p15-519236130.jpg",
                    "observacao": "Parte superior do cambio"
                }
            ]
        }
    ],
    "request": {
        "protocolo": "xxxxxxxxxxxx",
        "tipo_retorno": "JSON"
    }
}
```


---

# 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/consultar-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.
