API de campañas de recall

Respuesta rápida

Sabé si un vehículo tiene campañas de seguridad informadas por su fabricante: enviás la marca y el VIN, la API consulta en vivo la fuente de la marca y devuelve cada campaña con la evidencia de la consulta. El acceso lo habilita multas.ar para cada cuenta. La disponibilidad y el precio en créditos de cada servicio se confirman en tu panel.

Sabé si un vehículo tiene campañas de seguridad informadas por su fabricante: enviás la marca y el VIN, la API consulta en vivo la fuente de la marca y devuelve cada campaña con la evidencia de la consulta.

  • Un vehículo por pedido
  • Consulta en vivo al fabricante
  • Sin cargo si la fuente no confirma

El acceso lo habilita multas.ar para cada cuenta. La disponibilidad y el precio en créditos de cada servicio se confirman en tu panel.

Solicitar acceso

Qué devuelve cada consulta.

La respuesta trae el vehículo que identificó el fabricante, cada campaña que informa y la evidencia de dónde y cuándo se consultó.

datos.campanas
Cada campaña con número, descripción, fecha de lanzamiento, tipo, estado y número de parte, cuando el fabricante los informa.
datos.evidencia
La fuente consultada, la fecha y el resultado: campaigns_found si hay campañas o no_campaigns_reported si el fabricante no informa ninguna.
datos.modelo
Modelo y año que informa el fabricante para ese vehículo.
credits_used
Créditos cobrados por la consulta y saldo de la cuenta (credits_left).
error
Si el vehículo no se encuentra o la fuente no responde, la consulta falla con un código y se liberan los créditos reservados.

Ejemplo: Recall

Datos ficticios.

POST https://api.multas.ar/v1/recall
Authorization: Bearer <clave del servicio>
Idempotency-Key: alta-cliente-0001
Content-Type: application/json

{
  "marca": "honda",
  "vin": "8AFAR23L0EJ000001"
}

Respuesta final:

{
  "api": "recall",
  "requestId": "6e587da4-aecd-437d-b9e1-36cb00e03a8e",
  "status": "completed",
  "timestamp": "2026-11-10T12:00:41.000Z",
  "results": {
    "entrada": {
      "marca": "honda",
      "vin": "8AFAR23L0EJ000001"
    },
    "datos": {
      "marca": "honda",
      "vin": "8AFAR23L0EJ000001",
      "modelo": "MODELO DE EJEMPLO",
      "anio": "2014",
      "evidencia": {
        "version": 1,
        "type": "manufacturer_live",
        "outcome": "campaigns_found",
        "brand": "honda",
        "source": "https://autos.honda.com.ar/services/saneamiento",
        "queried_at": "2026-11-10T12:00:39.000Z"
      },
      "campanas": [
        {
          "numero": "CAMPAÑA-0001",
          "descripcion": "DESCRIPCIÓN DE EJEMPLO",
          "fechaLanzamiento": "2025-06-01",
          "tipo": "SEGURIDAD",
          "estado": "PENDIENTE",
          "numeroParte": null
        }
      ]
    },
    "credits_used": 1,
    "credits_left": 99
  }
}

Cómo se integra.

  1. Pedí acceso

    Desde la sección API de tu panel. Cuando se aprueba, creás una clave para el servicio y autorizás las IP desde donde vas a consultar.

  2. Enviá la consulta

    Un POST a /v1/recall con tu clave y una Idempotency-Key. Responde 202 con un requestId mientras procesa.

  3. Recibí el resultado

    Llega a tu webhook firmado y también se lee por GET con el requestId. Si reintentás con la misma Idempotency-Key, no se cobra dos veces.

Cobertura y límites.

  • Marcas incluidas

    Chevrolet, Citroën, DS, Fiat, Ford, Honda, Hyundai, Mercedes-Benz (autos y camiones), Nissan, Peugeot, RAM, Toyota y Volkswagen. Audi no está incluida.

  • Con el VIN

    El VIN de 17 caracteres identifica el vehículo. Toyota también admite la patente en su lugar, sin combinar los dos datos.

  • En vivo, sin listados

    Cada consulta va a la fuente del fabricante. No se usa un listado guardado como respaldo.

  • Plazo de 15 minutos

    Por consulta. El resultado se conserva siete días.

Para qué se usa.

  • Concesionarias y usados

    Revisá las campañas antes de entregar o tomar un vehículo.

  • Flotas

    Detectá unidades con campañas y coordiná el turno con el concesionario.

  • Talleres y posventa

    Consultá las campañas al recibir un vehículo en el taller.

  • Aseguradoras

    Sumá las campañas abiertas a la evaluación de un vehículo.

Sin campañas, con evidencia.

Un resultado sin campañas sólo vale cuando el fabricante respondió que no tiene campañas para ese vehículo, y la evidencia lo dice con no_campaigns_reported. Un vehículo no encontrado, una respuesta incompleta o un error de la fuente fallan sin cargo.

Otros servicios de la API.

Preguntas frecuentes

¿Qué marcas puedo consultar?

Chevrolet, Citroën, DS, Fiat, Ford, Honda, Hyundai, Mercedes-Benz (autos y camiones), Nissan, Peugeot, RAM, Toyota y Volkswagen. Audi no está incluida.

¿Necesito el VIN?

Sí, el VIN de 17 caracteres. Para Toyota también podés enviar la patente argentina en su lugar.

¿Qué pasa si el fabricante no responde?

La consulta falla con un código de error y se liberan los créditos reservados. Para volver a intentar, se crea una consulta nueva.

¿Cuánto se cobra?

Se cobra la consulta con respuesta confirmada del fabricante, haya o no campañas. Un vehículo no encontrado o un error de la fuente no se cobran.

¿Cómo obtengo acceso?

El acceso a la API lo habilita multas.ar para cada cuenta: no se activa solo. Pedilo desde la sección API de tu panel. Cuando se aprueba, creás una clave para el servicio y autorizás las IP desde donde vas a consultar.

Fuentes y metodología

Cobertura y limitaciones

Un resultado sin campañas sólo vale cuando el fabricante respondió que no tiene campañas para ese vehículo, y la evidencia lo dice con no_campaigns_reported. Un vehículo no encontrado, una respuesta incompleta o un error de la fuente fallan sin cargo.