Pular para o conteúdo principal
AnyCar
Consultar Placa Agora
Entrar

Novo aqui? Criar conta grátis

AnyCar Developers

A API da AnyCar, documentada para gente e agentes

Consulta veicular pela placa via REST: leilão, sinistro, gravame, restrições, FIPE e dados cadastrais. Contrato aberto em OpenAPI 3.1, autenticação simples por API key e um fluxo público de compra com Pix que qualquer agente de IA consegue seguir.

Ver especificação OpenAPICriar conta empresarial

Comece em minutos

  1. 1. Crie a conta empresarial

    O cadastro em /para-empresas/criar-conta usa CNPJ e ativa na hora, sem análise manual.

  2. 2. Pegue sua API key

    No portal do cliente, em Configurações, você gera e regenera a chave. Se quiser, restrinja o uso por whitelist de IP no mesmo lugar.

  3. 3. Faça a primeira chamada

    Envie a chave no header x-api-key. Os tipos de consulta habilitados no seu contrato estão em GET /api/status.

curl -X POST https://api.anycar.com.br/api/consultar \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tipo": "veicular-leilao-1", "placa": "ABC1D23"}'

Endpoints principais

Base URL: https://api.anycar.com.br. O contrato completo, com schemas e códigos de erro, está no openapi.json.

API contratada (header x-api-key)

MétodoRotaO que faz
POST/api/consultarConsulta avulsa por tipo (leilão, sinistro, gravame, FIPE, cadastral e outros)
GET/api/statusTipos de consulta habilitados no seu contrato
GET/api/laudo/planosPlanos de laudo veicular disponíveis
POST/api/laudo/consultarSolicita um laudo completo (entrega via webhook)
POST/api/vistoriaCria uma solicitação de vistoria veicular

Fluxo público do site (sem autenticação)

MétodoRotaO que faz
GET/publico/precos/1Planos e preços da consulta do site
POST/publico/test-drivePrévia gratuita pela placa (marca, modelo e ano)
POST/publico/solicitar-pagamentoGera o Pix de uma consulta (copia e cola + QR code)
GET/publico/solicitar-pagamento/{id}Status do pagamento; libera a consulta quando pago
GET/publico/consultas/{id}/statusAcompanha o processamento do laudo

Comprando uma consulta via agente de IA

O fluxo público do site funciona sem chave: o agente lista os planos, gera o Pix e apresenta o copia e cola para a pessoa pagar no app do banco. A confirmação é automática e o laudo sai no site e por e-mail.

  1. 1. Planos em GET /publico/precos/1
  2. 2. Pix em POST /publico/solicitar-pagamento (o corpo retorna brcode e QR code, válidos por 4 horas)
  3. 3. Confirmação em GET /publico/solicitar-pagamento/{id} (pago quando liberado: true; a resposta traz o ConId da consulta criada)
  4. 4. Laudo em GET /publico/consultas/{ConId}/status até aguarda: false
curl -X POST https://api.anycar.com.br/publico/solicitar-pagamento \
  -H "Content-Type: application/json" \
  -d '{
    "PlaId": 3,
    "email": "[email protected]",
    "nome": "Cliente Exemplo",
    "telefone": "11999998888",
    "placa": "ABC1D23",
    "metodo": "pix"
  }'

Convenções da API

Respostas

Toda resposta é JSON com o campo status (true ou false) e msg em português explicando o resultado.

Erros

401 chave inválida, 402 saldo insuficiente (pré-pago), 403 IP fora da whitelist ou contrato suspenso, 424 falha no fornecedor upstream (sem cobrança), 429 limite de requisições.

Consultas demoradas

Quando o fornecedor demora, a API responde 200 com processando: true e o header Retry-After. Repita a mesma chamada: o resultado vem do cache, sem custo duplicado.

Cobrança

Pay-per-use: pré-pago debita do saldo a cada consulta com sucesso; pós-pago é faturado. Sem assinatura e sem volume mínimo.

Webhooks

Configuráveis no portal do cliente (Configurações, Webhooks), com logs de entrega. O laudo veicular do B2B é entregue pelo webhook do tipo laudos.

Agentes via MCP

Hosts MCP (Claude, ChatGPT desktop e outros) conectam direto em https://api.anycar.com.br/mcp (Streamable HTTP, sem chave) e ganham o fluxo completo como tools: prévia gratuita, planos, geração do Pix e acompanhamento do laudo.

Versão e limites

Toda resposta traz X-Api-Version: 2; mudança incompatível vira versão nova, anunciada com os headers Deprecation e Sunset com 90 dias de antecedência. Rotas com limite retornam os headers RateLimit e, no 429, Retry-After.

PDF do resultado

Envie pdf: true em /api/consultar para receber, além do JSON, a URL de um PDF do resultado.

Recursos legíveis por máquina

  • Especificação OpenAPI 3.1

    Contrato completo da API: operações, schemas tipados, erros e exemplos. Também servido em https://api.anycar.com.br/openapi.json.

    https://anycar.com.br/openapi.json
  • Catálogo de APIs (RFC 9727)

    Linkset apontando especificação, documentação e health check.

    https://anycar.com.br/.well-known/api-catalog
  • Guia do site para LLMs

    O que é a AnyCar, quando usar e links das páginas principais. Versão longa em /llms-full.txt.

    https://anycar.com.br/llms.txt
  • Health check

    Disponibilidade da API em tempo real, sem autenticação.

    https://api.anycar.com.br/health
  • Servidor MCP (Model Context Protocol)

    A consulta veicular dentro de agentes de IA: prévia gratuita, planos, Pix e laudo como tools MCP (Streamable HTTP, sem autenticação). Server card em https://api.anycar.com.br/mcp/server-card.

    https://api.anycar.com.br/mcp

As páginas públicas do site também respondem markdown puro via header Accept: text/markdown, e caminhos inexistentes devolvem 404 com links de recuperação. Dúvidas de integração: [email protected].