Pular para o conteúdo
ZapCar
Developersv1

Listar serviços e preços

Catálogo de serviços liberados para a sua conta, com o preço que será cobrado e os campos que cada um exige.

GET/v1/servicos
GratuitoLeituraSandbox

Devolve os serviços liberados para a sua conta na API, com o preço que será cobrado (preço personalizado e grupo de desconto da API já aplicados) e os campos que cada um exige. É a chamada mais simples e gratuita: use-a para testar a chave.

Campo do itemPara que serve
servicoO slug para o campo servico do POST /v1/consultas.
requerOs campos que o serviço exige. É a fonte da verdade: leia daqui em vez de fixar no código.
precoO valor que o POST vai debitar.
preco_por_ufSó no crlv: preço, campos exigidos (requer) e disponibilidade de cada UF.
campos_por_ufSó em debitos-estadual.
opcionaisSó na consulta-completa: o adicional de incluir_fipe.
sincrono, endpointNos serviços de FIPE, que têm endpoint próprio e resposta imediata.
desconto_apiO grupo de desconto da API aplicado à conta, ou null.
Informação:
O exemplo ao lado é gerado com o catálogo e os preços vigentes no momento em que esta página foi publicada. Com a sua chave, a resposta reflete o seu preço. Serviço desligado ou indisponível na API não aparece na lista, e pedi-lo no POST responde 422 SERVICO_INDISPONIVEL. Ver todos os detalhes em Serviços disponíveis.
Pedido
curl "https://api.zapcarconsulta.com.br/v1/servicos" \
  -H "Authorization: Bearer $ZAPCAR_API_KEY"
Resposta
{
  "servicos": [
    { "servico": "consulta", "nome": "Consulta Simples", "requer": ["placa"], "preco": 5.98 },
    { "servico": "consulta-completa", "nome": "Consulta Completa", "requer": ["placa"], "preco": 38.99,
      "opcionais": { "incluir_fipe": { "preco_adicional": 0.25, "descricao": "Embute a Tabela FIPE da placa em dados.fipe." } } },
    { "servico": "ecv-premium", "nome": "Laudo ECV Premium", "requer": ["placa"], "preco": 42.99 },
    { "servico": "consulta-veicular", "nome": "Consulta Veicular", "requer": ["placa"], "preco": 24.99 },
    { "servico": "gravame", "nome": "Gravame", "requer": ["placa"], "preco": 6.99 },
    { "servico": "renajud", "nome": "Renajud", "requer": ["placa"], "preco": 6.99 },
    { "servico": "debitos", "nome": "Débitos + Código de Barras", "requer": ["placa"], "preco": 19.99 },
    { "servico": "debitos-estadual", "nome": "Débitos Estaduais", "requer": ["placa","uf"], "preco": 6.99,
      "observacao": "Serviço por estado. Os campos exigidos variam por UF, ver campos_por_uf.", "campos_por_uf": [ "..." ] },
    { "servico": "historico-proprietarios", "nome": "Histórico de Proprietários", "requer": ["placa"], "preco": 15.6 },
    { "servico": "comunicacao-venda", "nome": "Detalhe Comunicação de Venda", "requer": ["placa"], "preco": 6.99 },
    { "servico": "decodificacao-chassi", "nome": "Decodificação de Chassi", "requer": ["chassi"], "preco": 2.99 },
    { "servico": "decodificacao-motor", "nome": "Decodificação de Motor", "requer": ["motor"], "preco": 3.99 },
    { "servico": "score-credito", "nome": "Score de Crédito", "requer": ["documento"], "preco": 12.99 },
    { "servico": "situacao-cpf", "nome": "Situação do CPF", "requer": ["documento","data_nascimento"], "preco": 1.99 },
    { "servico": "cadastro-simples-cpf", "nome": "Cadastro Simples CPF", "requer": ["documento"], "preco": 4.9 },
    { "servico": "cadastro-completo-cpf", "nome": "Cadastro Completo CPF", "requer": ["documento"], "preco": 9.9 },
    { "servico": "cadastro-simples-cnpj", "nome": "Cadastro Simples CNPJ", "requer": ["documento"], "preco": 4.9 },
    { "servico": "cadastro-completo-cnpj", "nome": "Cadastro Completo CNPJ", "requer": ["documento"], "preco": 9.9 },
    { "servico": "fipe", "nome": "Tabela FIPE", "requer": ["placa"], "preco": 0.25,
      "sincrono": true, "endpoint": "POST /v1/fipe",
      "observacao": "Retorna os valores FIPE do veículo na hora (sem PDF, sem polling)." },
    { "servico": "credito-unico-cpf", "nome": "Crédito Único CPF", "requer": ["documento"], "preco": 9.9 },
    { "servico": "credito-biro-cpf", "nome": "Crédito Biro CPF", "requer": ["documento","uf"], "preco": 4.99 },
    { "servico": "credito-unico-cnpj", "nome": "Crédito Único CNPJ", "requer": ["documento"], "preco": 13.99 },
    { "servico": "credito-biro-cnpj", "nome": "Crédito Biro CNPJ", "requer": ["documento","uf"], "preco": 6.99 },
    { "servico": "cnh-nacional", "nome": "CNH Nacional", "requer": ["documento","cnh","uf"], "preco": 14.9 },
    { "servico": "debitos-trabalhistas", "nome": "Débitos Trabalhistas (CNDT)", "requer": ["documento"], "preco": 9.89 },
    { "servico": "divida-ativa", "nome": "Dívida Ativa da União", "requer": ["documento"], "preco": 7.9 },
    { "servico": "codigo-seguranca", "nome": "Código de Segurança", "requer": ["placa","renavam"], "preco": 19.99 },
    { "servico": "atpve", "nome": "2ª via do ATPV-e", "requer": ["placa"], "preco": 39.99 },
    { "servico": "consulta-nfe", "nome": "Consulta NF-e", "requer": ["chave"], "preco": 1.99 },
    { "servico": "crlv", "nome": "CRLV Digital", "requer": ["placa","uf"],
      "observacao": "Alguns estados exigem CPF/CNPJ e/ou RENAVAM, ver \"requer\" de cada UF.",
      "preco_por_uf": [
        { "uf": "AM", "preco": 31.99, "requer": ["placa","uf"] },
        { "uf": "AP", "preco": 29.99, "requer": ["placa","uf"] },
        { "uf": "BA", "preco": 29.99, "requer": ["placa","uf","cpf","renavam"] },
        { "uf": "CE", "preco": 44.99, "requer": ["placa","uf"] }
      ] }
  ],
  "desconto_api": null
}
Testar no API Explorer (sandbox)

Requisição

Cabeçalhos

Authorizationstringobrigatório
Sua chave no formato Bearer zc_live_… (produção) ou Bearer zc_test_… (teste). O cabeçalho X-API-Key também é aceito. Ver Autenticação.

Exemplo: Bearer zc_test_…

Respostas

  • 200
    Catálogo com os preços vigentes para esta conta.Corpo: CatalogoServicos
  • 401
    Chave ausente, inválida ou revogada.Corpo: ApiError
  • 429
    Rate limit excedido. Respeite o header Retry-After (segundos) antes de repetir. Não consome saldo.Corpo: ApiError
  • 500
    Falha interna inesperada. É transitória (retryable: true); informe o request_id ao suporte se persistir.Corpo: ApiError

Cabeçalhos da resposta

RateLimit-Limitintegerpode não vir
Teto de requisições da janela de 60s (120 em produção; 60 com chave de teste, em contador separado).
RateLimit-Remainingintegerpode não vir
Requisições restantes na janela atual.
RateLimit-Resetintegerpode não vir
Segundos até a janela zerar.
X-Request-Idstring (uuid)pode não vir
Id de correlação desta requisição. Informe ao suporte para localizar a chamada nos logs.