## DETRAN / DF / Veículo (Mobile)
Consulta cadastro do veículo no Departamento Estadual de Trânsito (DETRAN) do Distrito Federal (DF) através de aplicativo de celular.Se você deseja utilizar uma única API para consultar restrições de veículos em DETRANs de todos os estados do Brasil, recomendamos utilizar a API Detran / Restrições (Unificada).


### Site URL
- https://play.google.com/store/apps/details?id=br.com.mesotec.detrandf&hl=pt_BR&gl=US&pli=1

### Request
POST endpoint: `https://api.infosimples.com/api/v2/consultas/detran/df/veiculo/mobile`



| Parameter | Description                                                 |
| --------- | ----------------------------------------------------------- |
| token*    | The token that will authenticate and authorize the request. |
| placa*    | License plate of the vehicle to be queried.                 |
| renavam*  | RENAVAM of the vehicle to be queried.                       |

> * Required parameter.

> ** Optional parameter. Sometimes it is necessary to set at least one of the optional parameters for the service to work properly.


### Response examples (OK)
```json
{
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": {
    "api_version": "v2",
    "product": "Consultas",
    "service": "detran/df/veiculo/mobile",
    "parameters": {
      "placa": "AAA1111",
      "renavam": "1111111111"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.2",
    "requested_at": "2022-11-22T09:20:31.000-03:00",
    "elapsed_time_in_milliseconds": 164,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX1+KbiUWhlj9IiSKQeZdT1Qer0oZlxXOEI4FRfHTXJYZ0LCdNI1lFAF3qxvIAQbY2UBm7xt5Nbf6MA=="
  },
  "data_count": 1,
  "data": [
    {
      "ano": "2005",
      "ano_fabricacao": "2004",
      "ano_modelo": "2005",
      "capacidade_passageiros": null,
      "categoria": "PARTICULAR",
      "chassi": "1AA11111AA1111111",
      "combustivel": null,
      "cor": null,
      "debitos": {
        "licenciamentos": [
          {
            "ano": "2022",
            "vencimento": "23/02/2022",
            "valor": "87.66",
            "multa": "9.2",
            "mora": "9.11",
            "outros": "",
            "pago": "0.0",
            "total": "110.33"
          }
        ],
        "ipva": [],
        "dpvat": [],
        "detran": []
      },
      "especie": "Exemplo de espécie",
      "gravame": {
        "situacao": "VEÍCULO TEVE GRAVAME BAIXADO PELO AGENTE FINANCEIRO",
        "numero_restricao": "11111111",
        "numero_contrato": "1111111",
        "uf": "SP",
        "datahora": "14/11/2012 13:33:46",
        "financiado_documento": "12.345.678/9012-34",
        "financiado_nome": "Exemplo de nome",
        "agente_nome": "Exemplo de nome",
        "agente_codigo": "1111",
        "agente_documento": "12.345.678/9012-34"
      },
      "infracoes": [
        {
          "ait": "A123456789",
          "status": "Multa DF c/veiculo DF Notificada",
          "codigo_renainf": "",
          "orgao_autuador": "DETRAN - DF",
          "codigo_orgao_autuador": "123456",
          "regulamento": "",
          "descricao": "Exemplo de descrição",
          "velocidade_permitida": 0,
          "velocidade_aferida": 0,
          "local": "Avenida Paulista, 807",
          "data": "11/11/2011",
          "hora": "13:48",
          "responsavel": "Nome de Exemplo",
          "natureza": "Exemplo de Natureza",
          "pontos": 5,
          "data_notificacao": "10/03/2016",
          "data_penalidade": "26/02/2016",
          "data_limite_defesa": "01/01/2000",
          "vencimento": "19/08/2016",
          "valor": "191.54",
          "valor_com_desconto": "153.23",
          "valor_com_correcao": "191.54"
        }
      ],
      "marca": "FIAT",
      "modelo": "PALIO WEEK ELX FLEX",
      "municipio": "SAO PAULO / SP",
      "nacionalidade": null,
      "placa": "AAA1111",
      "potencia_cilindradas": "",
      "renavam": "1111111111",
      "restricoes": [
        "AL. FID.",
        "C.VENDA"
      ],
      "roubo_furto": "NADA CONSTA",
      "situacao_veiculo": "CIRCULACAO",
      "tipo": "AUTOMOVEL",
      "ultimo_licenciamento": "2015",
      "site_receipt": "https://www.exemplo.com/exemplo-de-url"
    }
  ],
  "site_receipts": []
}
```


### Preview file

The preview file (`site_receipts`) in the response JSON may be **synthesized by Infosimples** using data from the source (website/app) that processed the automation if the file generated by the source is not suitable for viewing.

### Code snippets


#### Python
```python
# Tested with: Python 3.10.19, Python 3.14.0
import requests

url = 'https://api.infosimples.com/api/v2/consultas/detran/df/veiculo/mobile'
args = {
  "placa":   "VALUE_OF_PARAMETER_PLACA",
  "renavam": "VALUE_OF_PARAMETER_RENAVAM",
  "token":   "WRITE_YOUR_TOKEN_HERE",
  "timeout": "300"
}

response = requests.post(url, args)
response_json = response.json()
response.close()

if response_json['code'] == 200:
  print("Retorno com sucesso: ", response_json['data'])
elif response_json['code'] in range(600, 799):
  mensagem = "Resultado sem sucesso. Leia para saber mais: \n"
  mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message'])
  mensagem += "; ".join(response_json['errors'])
  print(mensagem)

print("Cabeçalho da consulta: ", response_json['header'])
print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts'])
```


## We are here to help
Do you still need to figure something out? Reach us at [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) and our highly qualified support team will be happy to help.