# Multas MX

> API REST de consulta vehicular en México. Con una placa (o el NIV, para REPUVE) devuelve multas e infracciones de tránsito estatales y municipales, adeudo de tenencia, vigencia de placa, verificación vehicular y reporte de robo en REPUVE. Es asíncrona: responde al instante con un `requestId` y entrega el resultado por webhook firmado con HMAC o por consulta (polling). Se paga por consulta con créditos prepagados en pesos, y se prueba gratis con placas de prueba.

In English: Multas MX is a REST API for vehicle checks in Mexico by license plate: traffic fines (multas), vehicle tax debt (tenencia), plate validity (vigencia), emissions inspection (verificación) and stolen-vehicle reports (REPUVE). Results arrive asynchronously through signed webhooks or polling. Documentation is in Spanish; the OpenAPI spec below is machine-readable.

## Cuándo usar Multas MX

Úsalo cuando un sistema necesite, para vehículos de México:

- Saber si una placa tiene multas o infracciones de tránsito, pendientes o pagadas, con folio, fecha, monto y estatus, en los estados que lista `GET /states`.
- Revisar varias cosas de un vehículo en una sola llamada: multas de varios estados, tenencia, vigencia de placa, verificación y reporte de robo.
- Verificar un vehículo antes de comprarlo, rentarlo, asegurarlo o financiarlo, incluido el reporte de robo en REPUVE por placa o por NIV.
- Revisar una flotilla de forma periódica y recibir los resultados en su propio servidor por webhook.
- Integrar la consulta de adeudos vehiculares en una app, un CRM o un backoffice sin mantener una integración con cada portal de gobierno.

No es la herramienta adecuada para:

- Pagar multas o tenencia: sólo consulta, no procesa pagos al gobierno.
- Obtener datos del propietario (nombre, domicilio, CURP o RFC): no se entregan.
- Vehículos de fuera de México, o estados y servicios que no aparecen en `GET /states`.
- Respuestas inmediatas garantizadas: el servicio es asíncrono y best-effort, sin SLA; una consulta puede tardar de segundos a varios minutos.
- Revender la consulta tal cual como producto para el consumidor final: los Términos lo prohíben sin autorización escrita.

## Cómo llamarla

1. Pide al usuario la API key de su cuenta (se crea en https://dashboard.multasmx.com/register). Va en el header `x-api-key` de cada petición a `https://api.multasmx.com`.
2. `GET /states` devuelve los `stateCode` que se pueden consultar ahora y el `creditCost` de cada uno. No guardes la lista: cambia cuando un portal deja de responder.
3. `POST /lookup` con `{"plate": "ABC1234", "states": ["cdmx", "edomex"]}` responde `201` con un `requestId`. Cobra los créditos antes de ejecutar la consulta; si el saldo no alcanza responde `402` y no consulta nada.
4. `GET /lookup/{requestId}` devuelve el estado y los resultados. Repite la lectura con unos segundos de espera hasta que `status` deje de ser `PROCESSING`, o recibe el resultado en el webhook que el usuario configuró en el dashboard.
5. Para probar sin gastar créditos usa `plate` = `PRUEBA-ADEUDOS`, `PRUEBA-LIMPIA`, `PRUEBA-NOREG` o `PRUEBA-FALLA` (y para REPUVE, `niv` = `PRUEBA0000000001` a `PRUEBA0000000004`). Son gratis, devuelven datos ficticios y traen `sandbox: true`.
6. Respeta el límite de 60 peticiones por minuto por API key: la cabecera `RateLimit` dice cuántas quedan (`r`) y en cuántos segundos se reinicia la ventana (`t`); un `429` trae `Retry-After` en segundos.

Cómo leer el resultado:

- Un estado que aparece en `skipped[]` no se consultó (no estaba dando servicio) y no se cobró. No significa "sin multas".
- `QUEUED_RETRY` en un estado significa que el servicio no respondió y se reintenta solo. Todavía no es un resultado.
- `found: false` o `registered: false` son respuestas definitivas del portal (la placa no está en el padrón), no errores.
- Cada importe viene con su `unit`: `MXN` por defecto; la Ciudad de México usa `UC` (Unidades de Cuenta).

## Documentación

- [Documentación de la API](https://multasmx.com/docs.md): autenticación, `POST /lookup`, resultado de cada servicio, webhooks, créditos, límites y códigos de error
- [Especificación OpenAPI 3.1](https://multasmx.com/openapi.json): endpoints con `operationId`, esquemas de petición y respuesta, cabeceras de límite y webhooks
- [Precios](https://multasmx.com/pricing.md): paquetes de créditos y costo de cada consulta

## Empresa

- [Acerca de Multas MX](https://multasmx.com/about.md)
- [Contacto](https://multasmx.com/contact.md): contacto@multasmx.com
- [Términos de Servicio](https://multasmx.com/terms.md)
- [Política de Privacidad](https://multasmx.com/privacy.md)

## Optional

- [Portada](https://multasmx.com/index.md): presentación del producto, servicios y cobertura
- [Sitemap](https://multasmx.com/sitemap.xml)