# Documentación de Veriko

> Referencia de la API, conceptos y guías para validar transferencias SPEI y obtener su CEP.
> API reference, concepts and guides for validating SPEI transfers and obtaining their CEP.

## es

- [Documentación de Veriko](https://docs.veriko.mx/es): Referencia de la API, conceptos y guías para validar transferencias SPEI y obtener su CEP.
- [Changelog](https://docs.veriko.mx/es/changelog): Historial de cambios y novedades de Veriko
- [Guías paso a paso](https://docs.veriko.mx/es/how-to): Recetas orientadas a tareas para integrar la API de validación SPEI.
- [Servidor MCP](https://docs.veriko.mx/es/mcp): Conecta la API a tu editor o agente con el Model Context Protocol (MCP).
- [Esquemas](https://docs.veriko.mx/es/schemas): Catálogo de modelos JSON utilizados por la API. Cada esquema incluye descripción bilingüe, propiedades y referencias.
- [SDKs oficiales](https://docs.veriko.mx/es/sdks): Clientes oficiales para integrar la API desde Python y JavaScript.
- [Colección de la API (Bruno y Postman)](https://docs.veriko.mx/es/api-collection): La colección con las 75 operaciones de la API para Bruno y Postman: cómo abrirla, el flujo guiado y qué peticiones consumen cuota.
- [Códigos de bancos y catálogo SPEI](https://docs.veriko.mx/es/bank-directory): Los códigos de bancos del catálogo SPEI, con sus alias — cuándo hace falta uno, cómo encontrarlo y cómo obtenerlo por API.
- [¿De qué banco es una tarjeta?](https://docs.veriko.mx/es/card-lookup): Consulta el banco emisor de una tarjeta con sus primeros dígitos: red, débito o crédito, nivel y código SPEI. Sólo se usan los primeros 8 dígitos.
- [Ejemplos de código](https://docs.veriko.mx/es/code-examples): Ejemplos ejecutables de la API en cURL, Node.js, Python y PHP, y cómo correrlos.
- [Autenticación](https://docs.veriko.mx/es/concepts/api-authentication): API key en la cabecera Authorization, y cómo se obtiene y rota.
- [Superficies de la API](https://docs.veriko.mx/es/concepts/api-surfaces): Qué operaciones responden en el host de la API y cuáles solo en el panel.
- [Validaciones asíncronas](https://docs.veriko.mx/es/concepts/async-validations): El parámetro async, la respuesta 202 y el sondeo hasta el estado terminal.
- [Beneficiarios](https://docs.veriko.mx/es/concepts/beneficiaries): Qué es un beneficiario, porqué es bueno registrarlos y como afectan a las validaciones
- [API bilingüe](https://docs.veriko.mx/es/concepts/bilingual-api): Negociación de idioma, qué se traduce y qué permanece invariable.
- [Imports masivos](https://docs.veriko.mx/es/concepts/bulk-imports): Importación masiva de datos para beneficiarios y validaciones
- [Comprobante Electrónico de Pago (CEP)](https://docs.veriko.mx/es/concepts/cep-concept): Qué es un CEP, sus campos, los veredictos de una validación y cuándo aún no existe.
- [Caché condicional](https://docs.veriko.mx/es/concepts/conditional-caching): ETag, If-None-Match y la respuesta 304 sin cuerpo.
- [Retención de comprobantes y datos](https://docs.veriko.mx/es/concepts/data-retention): Qué conserva la plataforma de una validación, cómo evitar que guarde el archivo con retain_image y qué borra y qué deja el borrado definitivo.
- [Códigos de error](https://docs.veriko.mx/es/concepts/errors-taxonomy): Inventario completo de códigos de error, con su estado HTTP y qué hacer ante cada uno.
- [Errores](https://docs.veriko.mx/es/concepts/errors): Forma de un error, qué campo es estable y cómo ramificar sobre él.
- [Exportaciones y formatos](https://docs.veriko.mx/es/concepts/exports-and-formats): Cómo responde una exportación, qué formatos admite cada una y sus topes.
- [Finanzas](https://docs.veriko.mx/es/concepts/finance): Qué significa 'verificado' en Platform, los KPIs del resumen mensual, y cómo se exporta el archivo de CEPs.
- [Idempotencia](https://docs.veriko.mx/es/concepts/idempotency): Cabecera Idempotency-Key, ventana de 24 horas y reproducción de la respuesta.
- [Forma de las respuestas](https://docs.veriko.mx/es/concepts/json-api-envelope): El sobre JSON:API que envuelve toda respuesta — data, errors y meta.
- [Paginación](https://docs.veriko.mx/es/concepts/pagination): El estilo de paginación de la API y dónde aparece.
- [Enmascarado de datos sensibles](https://docs.veriko.mx/es/concepts/pii-masking): Qué se enmascara, qué no, y por qué la CLABE se trata distinto que una tarjeta.
- [Playground](https://docs.veriko.mx/es/concepts/playground): Ejecutar llamadas reales desde la consola sin exponer la API key.
- [Cuotas y planes](https://docs.veriko.mx/es/concepts/quotas-and-plans): Consumo mensual, cabeceras de cuota y qué ocurre al agotarla.
- [Límites de tasa](https://docs.veriko.mx/es/concepts/rate-limits): Límites por plan en la API y en los webhooks, ventana por minuto, respuesta 429 y cabeceras.
- [Política de reintentos](https://docs.veriko.mx/es/concepts/retry-policy): Reintento automático de validaciones sin veredicto, con sus topes.
- [Fechas y zona horaria](https://docs.veriko.mx/es/concepts/timezone-handling): Todo instante viaja en UTC con ISO 8601, en la respuesta y en los filtros.
- [Flujo de validación](https://docs.veriko.mx/es/concepts/validation-flow): Pipeline directo vs OCR, sync vs async, los siete estados terminales y los outcomes elegibles para retry.
- [Arquitectura de webhooks](https://docs.veriko.mx/es/concepts/webhooks-architecture): Firma, cabeceras, reintentos y desactivación automática de las entregas.
- [Analizar tendencias de validaciones y patrones de contraparte](https://docs.veriko.mx/es/how-to/analyze-insights): Comienza con el resumen de KPIs, profundiza en las tendencias de series temporales y luego explora qué bancos y beneficiarios dominan el volumen de tus validaciones.
- [Importación masiva de beneficiarios](https://docs.veriko.mx/es/how-to/beneficiary-import): Sube un archivo de cuentas beneficiarias, revisa las filas analizadas en cinco grupos de clasificación, corrige las filas corregibles y confirma la importación en tu lista de beneficiarios.
- [Configurar política de reintentos por defecto](https://docs.veriko.mx/es/how-to/configure-retry-policy): Lee y actualiza la política de reintentos por defecto que aplica a todas las nuevas validaciones cuando no se especifica una sobreescritura por validación.
- [Incrustar el widget del changelog](https://docs.veriko.mx/es/how-to/embed-changelog): Inserta un iframe en tu sitio para renderizar una lista del changelog autocontenida con CSS claro/oscuro y filtros de audiencia/idioma.
- [Obtener el sitemap del changelog](https://docs.veriko.mx/es/how-to/fetch-changelog-sitemap): Envía el sitemap XML Sitemaps 0.9 de los releases del changelog a motores de búsqueda para que los crawlers indexen las docs eficientemente.
- [Exportar estados de cuenta y archivos CEP](https://docs.veriko.mx/es/how-to/generate-finance-report): Comienza desde el resumen de KPIs, genera el estado de cuenta mensual en el formato que prefieras, profundiza en reportes especializados y descarga un archivo bulk de certificados CEP para conciliación contable.
- [Inspeccionar tu perfil de cuenta](https://docs.veriko.mx/es/how-to/inspect-my-account): Recupera el perfil completo de la cuenta autenticada en una sola llamada: datos de usuario, suscripción activa y estado de verificación.
- [Consultar, descargar y gestionar validaciones](https://docs.veriko.mx/es/how-to/inspect-validations): Lista tu historial de validaciones, inspecciona registros individuales, descarga certificados CEP e imágenes de comprobantes, exporta resultados a CSV o XLSX y gestiona el estado de reintentos por validación.
- [Listar entradas del changelog](https://docs.veriko.mx/es/how-to/list-changelog-entries): Obtén entradas del changelog del catálogo público con paginación por cursor y filtros por audiencia, idioma, categoría y rango de fechas.
- [Crear, actualizar y exportar beneficiarios](https://docs.veriko.mx/es/how-to/manage-beneficiaries): Gestiona tus cuentas beneficiarias guardadas — añade CLABEs, tarjetas y números DiMo a tu lista blanca, actualiza etiquetas, archiva entradas obsoletas y exporta la lista completa para conciliación.
- [Migrar a los nombres de campo en inglés](https://docs.veriko.mx/es/how-to/migrate-to-english-field-names): La API ahora emite cada campo en español también con su nombre en inglés, y los códigos de error pasan a inglés: qué cambia, qué no cambia y cómo migrar.
- [Rastrear cuota de API y consumo del ciclo de facturación](https://docs.veriko.mx/es/how-to/monitor-usage): Verifica la cuota del ciclo de facturación actual, inspecciona desglose por operación, visualiza tendencias históricas, monitorea límites de uso y exporta datos de consumo crudos.
- [Borrar una validación de forma definitiva](https://docs.veriko.mx/es/how-to/purge-a-validation): Borra el comprobante, el CEP y los datos de una validación propia en dos pasos, con un token de confirmación, y deja una lápida que conserva el veredicto, las fechas y el monto.
- [Registrar, probar y monitorear entregas de webhooks](https://docs.veriko.mx/es/how-to/set-up-webhooks): Lista tus endpoints de webhook, envía un evento de prueba para confirmar que el receptor es alcanzable, inspecciona los logs de entrega individuales y exporta el historial de entregas para auditoría.
- [Mostrar planes y precios en tu propia interfaz](https://docs.veriko.mx/es/how-to/show-plans-and-prices): Consulta el catálogo de planes con sus viñetas y precios, y la tabla comparativa, desde una página autenticada o desde una pública sin credenciales.
- [Suscribirse al feed Atom](https://docs.veriko.mx/es/how-to/subscribe-changelog-atom-feed): Recibe los releases del changelog en cualquier lector RSS via el feed Atom 1.0 con filtros de audiencia, idioma y límite.
- [Suscribirse al feed JSON](https://docs.veriko.mx/es/how-to/subscribe-changelog-json-feed): Recibe los releases del changelog en lectores JSON Feed 1.1 modernos como NetNewsWire o Reeder, o en scripts custom que prefieran JSON sobre XML.
- [Validar una transferencia SPEI desde un comprobante en imagen o PDF](https://docs.veriko.mx/es/how-to/validate-ocr): Sube un comprobante en imagen o PDF, o proporciona su URL, deja que el pipeline de OCR extraiga los campos del comprobante y recibe el mismo veredicto Banxico CEP que obtendrías con la validación manual.
- [Validar una transferencia SPEI (directa)](https://docs.veriko.mx/es/how-to/validate-spei): Envía los campos de una transferencia SPEI para validación contra el CEP de Banxico, sondea el resultado asíncrono y descarga el certificado CEP cuando la transferencia está confirmada.
- [Validación masiva de transferencias (consola)](https://docs.veriko.mx/es/how-to/validations-import-console): Sube un archivo de transferencias —o fotos de comprobantes— a la consola, revisa cómo quedó clasificada cada fila, corrige las corregibles y confirma el lote para validarlas todas contra Banxico en una sola operación.
- [Servidor MCP](https://docs.veriko.mx/es/mcp-server): El servidor MCP oficial conecta la API con Cursor y con cualquier cliente compatible: instalación, perfiles, niveles de riesgo y cuota.
- [Playground y pruebas](https://docs.veriko.mx/es/playground-and-testing): La API no tiene host de pruebas ni bandera de simulación en el cuerpo — qué consume cuota, qué no, dónde corre una llamada sin efectos y cómo construir casos reproducibles.
- [Inicio rápido](https://docs.veriko.mx/es/quick-start): Tu primera petición a la API — Validar una transferencia SPEI y leer el resultado.
- [SDK de JavaScript](https://docs.veriko.mx/es/sdk-javascript): El cliente oficial para Node y TypeScript: instálalo, valida una transferencia SPEI y verifica la firma de un webhook.
- [SDK de Python](https://docs.veriko.mx/es/sdk-python): El cliente oficial para Python: instálalo, valida una transferencia SPEI y verifica la firma de un webhook.
- [Seguridad y manejo de datos](https://docs.veriko.mx/es/security-and-compliance): Qué se guarda de cada validación, cómo se protege la clave, cómo se firman los webhooks, cómo se sanean las imágenes y cuánto dura cada dato.
- [Consultar el estado del servicio de verificación de Banxico](https://docs.veriko.mx/es/v1/banxico-status/banxico-public-status): Devuelve el estado operativo actual del servicio de verificación de Banxico, derivado de chequeos periódicos de salud.
- [Obtener la serie temporal de salud del servicio de verificación de Banxico](https://docs.veriko.mx/es/v1/banxico-status/banxico-public-timeseries): Devuelve el estado operativo histórico del servicio de verificación de Banxico, agrupado en puntos de datos por intervalo de tiempo para la métrica y ventana solicitadas.
- [Cancelar una importación en curso](https://docs.veriko.mx/es/v1/beneficiaries/cancel-beneficiary-import): Cancela un trabajo de importación que aún no se ha confirmado (en estado pending, parsing o preview_ready).
- [Confirmar la importación masiva](https://docs.veriko.mx/es/v1/beneficiaries/commit-beneficiary-import): Confirma un trabajo de importación y dispara la persistencia de sus filas en GET /v1/beneficiaries.
- [Iniciar importación masiva de beneficiarios](https://docs.veriko.mx/es/v1/beneficiaries/create-beneficiary-import): Sube un archivo (CSV, XLS, XLSX, TXT, JSON o PDF) de hasta 20 MB y abre con él un trabajo de importación. Las hojas XLSX/XLS admiten hasta 10 000 filas y 64 columnas. Las fórmulas XLSX se leen como texto, sin ejecutarlas. Los PDF admiten hasta 50 páginas y limitan a 8 MiB la descompresión de cada flujo.
- [Crear un beneficiario](https://docs.veriko.mx/es/v1/beneficiaries/create-beneficiary): Registra una cuenta beneficiaria nueva. El tipo de cuenta se autodetecta por la longitud, y de eso depende qué campos se envían en la petición:
- [Quitar una fila de la vista previa](https://docs.veriko.mx/es/v1/beneficiaries/delete-beneficiary-import-row): Elimina una fila de un trabajo de importación propio antes de confirmarlo.
- [Archivar un beneficiario](https://docs.veriko.mx/es/v1/beneficiaries/delete-beneficiary): Archiva la cuenta beneficiaria. El registro no se borra: sale de la lista activa y visible, las validaciones históricas que lo referencian siguen intactas, de modo que archivar un beneficiario no afecta su historial de validaciones.
- [Descargar la plantilla de importación de beneficiarios](https://docs.veriko.mx/es/v1/beneficiaries/download-beneficiary-import-template): Devuelve un archivo plantilla para la importación de beneficiarios en el formato solicitado, con los encabezados fijos alias, cuenta y banco y filas de ejemplo para CLABE, tarjeta y celular/DiMo. Sirve de punto de partida para la importación masiva.
- [Exportar los beneficiarios de la cuenta de usuario](https://docs.veriko.mx/es/v1/beneficiaries/export-beneficiaries): Descarga las cuentas beneficiarias del usuario autenticado como archivo, usa el mismo filtro with_archived que GET /v1/beneficiaries.
- [Previsualizar las filas extraídas de la importación](https://docs.veriko.mx/es/v1/beneficiaries/get-beneficiary-import-preview): Devuelve las filas extraídas del archivo en un trabajo de importación (paginadas y filtrables por grupo).
- [Consultar el estado de una importación](https://docs.veriko.mx/es/v1/beneficiaries/get-beneficiary-import): Devuelve el estado de un trabajo de importación y sus contadores por grupo: valid, correctable, fatal, duplicate_account (sumados en duplicate_count) y committed/skipped tras la confirmación.
- [Listar beneficiarios](https://docs.veriko.mx/es/v1/beneficiaries/list-beneficiaries): Devuelve las cuentas beneficiarias guardadas del usuario autenticado. La lista reúne los tres tipos de beneficiarios (CLABE, tarjeta y celular/DiMo).
- [Buscar cuenta en lista blanca propia](https://docs.veriko.mx/es/v1/beneficiaries/lookup-beneficiary-account): Busca un número de cuenta exacto dentro de la lista de beneficiarios del usuario autenticado. Cuando existe, la respuesta trae los datos del banco.
- [Editar una fila de la vista previa](https://docs.veriko.mx/es/v1/beneficiaries/patch-beneficiary-import-row): Permite corregir una fila de la vista previa antes de confirmar la persistencia de un trabajo de importación. Acepta envoltorio JSON:API o un objeto plano. Todos los atributos son opcionales; solo se sobreescriben los presentes.
- [Actualizar un beneficiario](https://docs.veriko.mx/es/v1/beneficiaries/update-beneficiary): Actualiza un beneficiario ya registrado. El cuerpo admite la envoltura JSON:API o un objeto plano, y lo que se envíe determina el alcance del cambio:
- [Validar estructura de cuenta (CLABE, tarjeta o celular)](https://docs.veriko.mx/es/v1/beneficiaries/validate-account): Comprueba la estructura de un número de cuenta. El tipo de cuenta se detecta por la longitud: CLABE (18 dígitos), tarjeta (16 dígitos), celular/DiMo (10 dígitos).
- [Consultar suscripción activa del usuario](https://docs.veriko.mx/es/v1/billing/billing-get-subscription): Devuelve la suscripción activa del usuario autenticado. La respuesta siempre contiene un recurso: si no existe una suscripción activa, el servidor asigna el plan predeterminado.
- [Obtener el resumen del panel](https://docs.veriko.mx/es/v1/dashboard/get-dashboard-summary): Devuelve los contadores agregados del usuario: el total histórico, el total del mes UTC en curso, las validaciones con veredicto valid, el contador mensual de los estados queued y processing, el monto promedio y la tasa de éxito. Incluye también la cantidad de beneficiarios activos.
- [Pedir el archivo de comprobantes en segundo plano](https://docs.veriko.mx/es/v1/finance/create-finance-cep-export): Encola la preparación del ZIP de CEP de un rango de fechas y responde de inmediato con un estado HTTP 202. Es la alternativa asíncrona de GET /v1/finance/ceps para rangos grandes: el archivo se arma en segundo plano, sin mantener la conexión abierta.
- [Descargar el archivo de una exportación de comprobantes](https://docs.veriko.mx/es/v1/finance/download-finance-cep-export): Entrega el ZIP de una exportación asíncrona de CEP que está ready. Es el mismo archivo que GET /v1/finance/ceps: los XML y PDF bajo ceps/ y los manifiestos manifest.csv y manifest.xlsx.
- [Exportar la contabilidad (CSV, XLSX o PDF)](https://docs.veriko.mx/es/v1/finance/get-finance-accounting): Exporta las mismas columnas que el reporte mensual de verificaciones (15 columnas, formato compatible con el SAT), fechas en formato DD/MM/YYYY y separador decimal configurable.
- [Obtener el resumen por banco receptor (CSV, XLSX o PDF)](https://docs.veriko.mx/es/v1/finance/get-finance-by-bank): Agrupa las verificaciones del mes por banco receptor (banxico_code), con totales, conteo de válidas, tasa de éxito y monto total. Contiene 6 columnas:
- [Consultar el estado de una exportación de comprobantes](https://docs.veriko.mx/es/v1/finance/get-finance-cep-export): Devuelve el estado de una exportación asíncrona de CEP. Mientras status sea queued o building, vuelve a consultar con una pausa de unos segundos; ready, failed y expired son terminales.
- [Descargar los comprobantes en un archivo comprimido](https://docs.veriko.mx/es/v1/finance/get-finance-ceps): Entrega en un solo ZIP todos los archivos CEP disponibles de un rango de fechas.
- [Obtener el resumen por contraparte (CSV, XLSX o PDF)](https://docs.veriko.mx/es/v1/finance/get-finance-counterparties): Agrupa las verificaciones del mes por cuenta beneficiaria y banco, incluye 7 columnas:
- [Obtener el informe mensual de verificaciones (CSV, XLSX o PDF)](https://docs.veriko.mx/es/v1/finance/get-finance-monthly): Devuelve el listado (en formato compatible con el SAT) de las verificaciones del mes en 15 columnas:
- [Obtener el estado de cuenta mensual (PDF, XLSX, CSV o HTML)](https://docs.veriko.mx/es/v1/finance/get-finance-statement): Genera el estado de cuenta financiero del mes en cuatro formatos:
- [Consultar el resumen financiero del mes](https://docs.veriko.mx/es/v1/finance/get-finance-summary): Devuelve los KPIs del mes para el panel /finanzas:
- [Listar las exportaciones recientes de comprobantes](https://docs.veriko.mx/es/v1/finance/list-finance-cep-exports): Devuelve las últimas 20 exportaciones asíncronas de CEP que pidió quien consulta, la más reciente primero, con su estado, tamaño y vencimiento.
- [Consultar las métricas de validaciones de la cuenta de usuario](https://docs.veriko.mx/es/v1/insights/get-user-insights-overview): Devuelve las métricas de validaciones para el usuario autenticado:
- [Listar los bancos de la cuenta de usuario por volumen de validaciones o tasa de error](https://docs.veriko.mx/es/v1/insights/get-user-insights-top-banks): Lista los bancos usados en las validaciones del usuario autenticado durante los últimos 30 días, ordenados por volumen total o por tasa de error.
- [Listar los beneficiarios más frecuentes en las validaciones de la cuenta de usuario](https://docs.veriko.mx/es/v1/insights/get-user-insights-top-beneficiaries): Lista los beneficiarios detectados con mayor frecuencia en las validaciones del usuario autenticado durante los últimos 90 días.
- [Obtener las series temporales de validaciones de la cuenta de usuario](https://docs.veriko.mx/es/v1/insights/get-user-insights-trends): Devuelve una serie temporal que representa las validaciones del usuario autenticado, según el rango y la métrica seleccionados.
- [Obtener la tabla comparativa de planes](https://docs.veriko.mx/es/v1/plans/get-public-plan-comparison): Devuelve la tabla «Compara los planes» de /pricing como datos estructurados.
- [Listar el catálogo público de planes](https://docs.veriko.mx/es/v1/plans/list-public-plans): Devuelve el catálogo de planes para las superficies sin autenticación (la landing /pricing y los widgets embebibles).
- [Obtener el calendario de días inhábiles SPEI de un año](https://docs.veriko.mx/es/v1/public/get-spei-calendar): Devuelve el calendario de días inhábiles SPEI de un año, con la disposición oficial de la que sale.
- [Listar los bancos participantes con su código](https://docs.veriko.mx/es/v1/public/list-banks): Devuelve el catálogo actual de instituciones bancarias participantes del sistema SPEI. El catálogo es actualizado semanalmente desde las listas oficiales del Banco de México (Banxico).
- [Obtener el banco de una Tarjeta](https://docs.veriko.mx/es/v1/public/lookup-bin): Resuelve el banco emisor de una tarjeta bancaria a partir de su BIN (Bank Identification Number).
- [Exportar el registro de actividad como CSV o XLSX](https://docs.veriko.mx/es/v1/usage/export-api-usage): Descarga el registro de actividad API del usuario autenticado.
- [Obtener métricas de uso de la API](https://docs.veriko.mx/es/v1/usage/get-api-usage): Devuelve las métricas de uso de la API del usuario autenticado:
- [Desglosar consumo por operación](https://docs.veriko.mx/es/v1/usage/get-usage-breakdown): Desglosa el consumo del periodo indicado por tipo de operación contabilizada (validation y sms_2fa).
- [Obtener el mapa de calor de validaciones por día y hora](https://docs.veriko.mx/es/v1/usage/get-usage-heatmap): Devuelve las validaciones del usuario agrupadas por día de la semana y hora del día, para los últimos days días (máximo 90).
- [Consultar índices de consumo mes a mes](https://docs.veriko.mx/es/v1/usage/get-usage-history): Devuelve el consumo mensual de validaciones del usuario autenticado en hasta months meses con consumo, de más reciente a más antiguo. Los meses sin consumo no aparecen.
- [Consultar los límites de tasa (rate-limits)](https://docs.veriko.mx/es/v1/usage/get-usage-limits): Devuelve los límites de tasa aplicables al usuario autenticado, por contexto.
- [Consultar la cuota de validaciones para el plan del usuario](https://docs.veriko.mx/es/v1/usage/get-usage-summary): Devuelve la cuota de validaciones del plan asignado al usuario autenticado:
- [Obtener la política de reintentos de una cuenta de usuario](https://docs.veriko.mx/es/v1/users/get-my-retry-policy): Devuelve la política de reintentos configurada en la cuenta del usuario autenticado.
- [Obtener la información de una cuenta de usuario](https://docs.veriko.mx/es/v1/users/my-profile): Devuelve en una sola llamada todos los datos recabados del usuario autenticado:
- [Establecer la política de reintentos en una cuenta de usuario](https://docs.veriko.mx/es/v1/users/update-my-retry-policy): Fija la política de reintentos que se aplicará a la cuenta del usuario autenticado.
- [Cancelar reintentos pendientes](https://docs.veriko.mx/es/v1/validations/cancel-validation-retries): Cancela el ciclo activo de reintentos automáticos de una validación y devuelve terminal_state="cancelled".
- [Retirar una validación del historial](https://docs.veriko.mx/es/v1/validations/delete-validation): Retira una validación del historial de validaciones del usuario autenticado.
- [Descargar el CEP oficial](https://docs.veriko.mx/es/v1/validations/download-cep): Descarga el Comprobante Electrónico de Pago (CEP) emitido por Banxico de una validación con veredicto valid, o returned cuando el CEP se descargó antes de conocerse la devolución.
- [Ejecutar el borrado definitivo de una validación](https://docs.veriko.mx/es/v1/validations/execute-validation-purge): Borra de forma definitiva el contenido de una validación propia, con el token que emitió POST /v1/validations/{id}/purge/prepare. Es el segundo paso de un flujo de dos pasos: sin ese token no se borra nada.
- [Exportar validaciones](https://docs.veriko.mx/es/v1/validations/export-validations): Descarga en un archivo las validaciones que cumplen los filtros.
- [Obtener la imagen del comprobante](https://docs.veriko.mx/es/v1/validations/get-validation-image): Devuelve el comprobante conservado de una validación por OCR, con caché privada:
- [Obtener una validación](https://docs.veriko.mx/es/v1/validations/get-validation): Devuelve el registro completo de una validación, con su veredicto, los datos normalizados y el estado de los reintentos.
- [Listar intentos de reintento](https://docs.veriko.mx/es/v1/validations/list-validation-retry-attempts): Devuelve el historial cronológico de los reintentos automáticos de una validación.
- [Listar validaciones](https://docs.veriko.mx/es/v1/validations/list-validations): Devuelve el historial paginado de validaciones del usuario autenticado.
- [Preparar el borrado definitivo de una validación](https://docs.veriko.mx/es/v1/validations/prepare-validation-purge): Describe lo que borraría el borrado definitivo de una validación propia y emite el token con el que POST /v1/validations/{id}/purge/execute lo confirma. No cambia nada: la validación y sus archivos quedan como estaban.
- [Volver a consultar el estado de pago de una validación](https://docs.veriko.mx/es/v1/validations/recheck-validation): Vuelve a consultar a Banxico el estado del pago de una validación valid y, si lo reporta devuelto, la pasa a returned.
- [Enviar el comprobante al chat de Telegram vinculado](https://docs.veriko.mx/es/v1/validations/send-cep-to-telegram): Inicia el envío del CEP en PDF al chat de Telegram vinculado con la cuenta de usuario propietaria.
- [Configurar política de reintentos](https://docs.veriko.mx/es/v1/validations/update-validation-retry-policy): Activa una política de reintentos automáticos para una validación con veredicto not_found, cep_unavailable o error.
- [Validar manualmente una transferencia SPEI](https://docs.veriko.mx/es/v1/validations/validate-direct): Valida manualmente una transferencia SPEI para obtener el comprobante (CEP) de Banxico.
- [Validar una transferencia SPEI (OCR)](https://docs.veriko.mx/es/v1/validations/validate-ocr): Valida una transferencia SPEI a partir de su comprobante, en imagen o en PDF. Extrae mediante reconocimiento óptico (OCR) los datos del comprobante y los valida en Banxico para obtener el CEP de la transacción.
- [Obtener las estadísticas de validaciones de la cuenta de usuario](https://docs.veriko.mx/es/v1/validations/validation-stats): Devuelve contadores agregados de las validaciones de la cuenta:
- [Crear un endpoint webhook para recibir eventos](https://docs.veriko.mx/es/v1/webhooks/create-webhook): Registra un endpoint HTTPS que recibirá los eventos suscritos. La URL debe resolver a una dirección pública: localhost y los rangos privados se rechazan.
- [Eliminar un endpoint webhook](https://docs.veriko.mx/es/v1/webhooks/delete-webhook): Elimina el endpoint webhook y todo su historial de entregas. No hay archivado: el registro desaparece y no se puede recuperar.
- [Exportar todas las entregas webhook como CSV o XLSX](https://docs.veriko.mx/es/v1/webhooks/export-all-deliveries): Descarga el historial de entregas de todos los endpoints de la cuenta de usuario en un archivo, con los mismos filtros y la misma búsqueda (q) que el listado.
- [Exportar las entregas de un endpoint webhook como CSV o XLSX](https://docs.veriko.mx/es/v1/webhooks/export-webhook-deliveries): Descarga hasta 100 000 registros del historial de entregas de un endpoint específico, en formato CSV o XLSX.
- [Listar entregas de todos los endpoints webhook](https://docs.veriko.mx/es/v1/webhooks/list-all-deliveries): Devuelve una vista consolidada de las entregas hechas a los endpoints webhook del usuario autenticado.
- [Listar entregas de un endpoint webhook](https://docs.veriko.mx/es/v1/webhooks/list-webhook-deliveries): Devuelve los intentos de entrega de un endpoint webhook específico, de la entrega más reciente a la más antigua, con paginación.
- [Listar endpoints webhook registrados](https://docs.veriko.mx/es/v1/webhooks/list-webhooks): Devuelve los endpoints webhook del usuario autenticado, con su estado actual y los eventos a los que están suscritos.
- [Regenerar la firma secreta de un endpoint webhook](https://docs.veriko.mx/es/v1/webhooks/regenerate-webhook-secret): Rota el secreto con el que se firman las entregas de un endpoint webhook. El secreto nuevo viaja una sola vez, en esta respuesta, y no hay forma de volver a consultarlo.
- [Enviar evento de prueba al endpoint webhook](https://docs.veriko.mx/es/v1/webhooks/send-webhook-test): Envía una entrega sintética al endpoint webhook para comprobar que el receptor está en pie.
- [Actualizar un endpoint webhook](https://docs.veriko.mx/es/v1/webhooks/update-webhook): Actualiza la URL, los eventos suscritos o el estado de un endpoint webhook ya registrado.

## en

- [Veriko documentation](https://docs.veriko.mx/en): API reference, concepts and guides for validating SPEI transfers and obtaining their CEP.
- [Changelog](https://docs.veriko.mx/en/changelog): Change history and release notes for Veriko
- [How-to guides](https://docs.veriko.mx/en/how-to): Task-oriented recipes for integrating the SPEI validation API.
- [MCP server](https://docs.veriko.mx/en/mcp): Connect the API to your editor or agent via the Model Context Protocol (MCP).
- [Schemas](https://docs.veriko.mx/en/schemas): Directory of JSON models used by the API. Every schema carries a bilingual description, property table and cross-references.
- [Official SDKs](https://docs.veriko.mx/en/sdks): Official clients to integrate the API from Python and JavaScript.
- [API collection (Bruno and Postman)](https://docs.veriko.mx/en/api-collection): The collection with the 75 operations of the API for Bruno and Postman: how to open it, the guided flow and which requests consume quota.
- [Bank codes and SPEI catalog](https://docs.veriko.mx/en/bank-directory): The bank codes in the SPEI catalog, with their aliases — when one is needed, how to find it, and how to fetch it from the API.
- [Which bank issued a card?](https://docs.veriko.mx/en/card-lookup): Look up the issuing bank of a card from its first digits: network, debit or credit, level and SPEI code. Only the first 8 digits are used.
- [Code examples](https://docs.veriko.mx/en/code-examples): Runnable examples of the API in cURL, Node.js, Python and PHP, and how to run them.
- [Authentication](https://docs.veriko.mx/en/concepts/api-authentication): API key in the Authorization header, and how it is obtained and rotated.
- [API surfaces](https://docs.veriko.mx/en/concepts/api-surfaces): Which operations answer on the API host and which only in the dashboard.
- [Asynchronous validations](https://docs.veriko.mx/en/concepts/async-validations): The async parameter, the 202 response and polling to a terminal state.
- [Beneficiaries](https://docs.veriko.mx/en/concepts/beneficiaries): What a beneficiary is, why it's worth registering them, and how they affect validations
- [Bilingual API](https://docs.veriko.mx/en/concepts/bilingual-api): Language negotiation, what gets translated and what stays invariable.
- [Bulk imports](https://docs.veriko.mx/en/concepts/bulk-imports): Bulk data import for beneficiaries and validations
- [Electronic Payment Receipt (CEP)](https://docs.veriko.mx/en/concepts/cep-concept): What a CEP is, its fields, a validation's verdicts, and when it does not exist yet.
- [Conditional caching](https://docs.veriko.mx/en/concepts/conditional-caching): ETag, If-None-Match and the bodyless 304 response.
- [Retention of receipts and data](https://docs.veriko.mx/en/concepts/data-retention): What the platform keeps of a validation, how to stop it from keeping the file with retain_image, and what the permanent deletion removes and leaves behind.
- [Error codes](https://docs.veriko.mx/en/concepts/errors-taxonomy): Full inventory of error codes, with their HTTP status and what to do about each.
- [Errors](https://docs.veriko.mx/en/concepts/errors): The shape of an error, which field is stable and how to branch on it.
- [Exports and formats](https://docs.veriko.mx/en/concepts/exports-and-formats): How an export responds, which formats each one accepts and their caps.
- [Finance](https://docs.veriko.mx/en/concepts/finance): What 'verified' means in Platform, the monthly summary KPIs, and how the CEP archive is exported.
- [Idempotency](https://docs.veriko.mx/en/concepts/idempotency): The Idempotency-Key header, its 24-hour window and response replay.
- [Response shape](https://docs.veriko.mx/en/concepts/json-api-envelope): The JSON:API envelope wrapping every response — data, errors and meta.
- [Pagination](https://docs.veriko.mx/en/concepts/pagination): The API's pagination style and where it appears.
- [Masking of sensitive data](https://docs.veriko.mx/en/concepts/pii-masking): What gets masked, what does not, and why a CLABE is treated differently from a card.
- [Playground](https://docs.veriko.mx/en/concepts/playground): Running real calls from the console without exposing the API key.
- [Quotas and plans](https://docs.veriko.mx/en/concepts/quotas-and-plans): Monthly consumption, quota headers and what happens when it runs out.
- [Rate limits](https://docs.veriko.mx/en/concepts/rate-limits): Limits per plan on the API and on webhooks, the per-minute window, the 429 response and its headers.
- [Retry policy](https://docs.veriko.mx/en/concepts/retry-policy): Automatic retry of validations left without a verdict, and its caps.
- [Dates and time zone](https://docs.veriko.mx/en/concepts/timezone-handling): Every instant travels in UTC as ISO 8601, in responses and in filters.
- [Validation flow](https://docs.veriko.mx/en/concepts/validation-flow): Direct pipeline vs OCR, sync vs async, the seven terminal states, and the outcomes eligible for retry.
- [Webhooks architecture](https://docs.veriko.mx/en/concepts/webhooks-architecture): Signing, headers, retries and automatic deactivation of deliveries.
- [Analyze validation trends and counterparty patterns](https://docs.veriko.mx/en/how-to/analyze-insights): Start with the KPI overview, drill into time-series trends, then explore which banks and beneficiaries dominate your validation volume.
- [Bulk beneficiary import](https://docs.veriko.mx/en/how-to/beneficiary-import): Upload a file of beneficiary accounts, review the parsed rows across five classification buckets, fix the correctable rows, and commit the import to your beneficiary list.
- [Configure a default retry policy](https://docs.veriko.mx/en/how-to/configure-retry-policy): Read and update the default retry policy that applies to all new validations when no per-validation override is specified.
- [Embed the changelog widget](https://docs.veriko.mx/en/how-to/embed-changelog): Drop an iframe into your site to render a live, self-contained changelog list with light/dark CSS and audience/language filters.
- [Fetch the changelog sitemap](https://docs.veriko.mx/en/how-to/fetch-changelog-sitemap): Submit the Sitemaps 0.9 XML sitemap of changelog releases to search engines so crawlers can index the docs efficiently.
- [Export financial statements and CEP archives](https://docs.veriko.mx/en/how-to/generate-finance-report): Start from the KPI summary, generate the monthly statement in your preferred format, drill into specialized reports, and download a bulk CEP archive for accounting reconciliation.
- [Inspect your account profile](https://docs.veriko.mx/en/how-to/inspect-my-account): Retrieve the complete profile for the authenticated account in a single call: user data, active subscription, and verification status.
- [Browse, download, and manage validation records](https://docs.veriko.mx/en/how-to/inspect-validations): List your validation history, inspect individual records, download CEP certificates and receipt images, export results to CSV or XLSX, and manage retry state for in-progress validations.
- [List changelog entries](https://docs.veriko.mx/en/how-to/list-changelog-entries): Fetch cursor-paginated changelog entries from the public catalog, with filters for audience, language, category, and date range.
- [Create, update, and export beneficiaries](https://docs.veriko.mx/en/how-to/manage-beneficiaries): Manage your saved beneficiary accounts — add CLABEs, cards, and DiMo numbers to your whitelist, update labels, archive stale entries, and export the full list for reconciliation.
- [Migrate to English field names](https://docs.veriko.mx/en/how-to/migrate-to-english-field-names): The API now also emits every Spanish field with its English name, and error codes switch to English: what changes, what does not, and how to migrate.
- [Track API quota and billing-cycle consumption](https://docs.veriko.mx/en/how-to/monitor-usage): Check your current billing-cycle quota, inspect per-operation breakdowns, view historical trends, monitor usage limits, and export raw usage data.
- [Permanently delete a validation](https://docs.veriko.mx/en/how-to/purge-a-validation): Delete the receipt, the CEP, and the data of one of your own validations in two steps, with a confirmation token, leaving a tombstone that keeps the verdict, the dates, and the amount.
- [Register, test, and monitor webhook deliveries](https://docs.veriko.mx/en/how-to/set-up-webhooks): List your webhook endpoints, fire a test event to confirm the receiver is reachable, inspect individual delivery logs, and export delivery history for audit.
- [Show plans and prices in your own interface](https://docs.veriko.mx/en/how-to/show-plans-and-prices): Read the plan catalogue with its bullets and prices, and the comparison table, either from an authenticated page or from a public one with no credentials.
- [Subscribe to the Atom feed](https://docs.veriko.mx/en/how-to/subscribe-changelog-atom-feed): Pull changelog releases into any RSS reader via the Atom 1.0 feed with audience, language, and limit filters.
- [Subscribe to the JSON feed](https://docs.veriko.mx/en/how-to/subscribe-changelog-json-feed): Pull changelog releases into modern JSON Feed 1.1 readers like NetNewsWire or Reeder, or into custom scripts that prefer JSON over XML.
- [Validate a SPEI transfer from a receipt image or PDF](https://docs.veriko.mx/en/how-to/validate-ocr): Upload a receipt image or PDF, or provide its URL, let the OCR pipeline extract the transfer fields, and receive the same Banxico CEP verdict you would get from the manual validation endpoint.
- [Validate a SPEI transfer (direct)](https://docs.veriko.mx/en/how-to/validate-spei): Submit the fields of a SPEI transfer for validation against the Banxico CEP, poll the async result, and download the CEP certificate when the transfer is confirmed.
- [Bulk validation of transfers (console)](https://docs.veriko.mx/en/how-to/validations-import-console): Upload a file of transfers — or photos of the receipts — to the console, review how each row was classified, fix the correctable ones and confirm the batch to validate them all against Banxico in one go.
- [MCP server](https://docs.veriko.mx/en/mcp-server): The official MCP server connects the API to Cursor and to any compatible client: installation, profiles, risk levels and quota.
- [Playground and testing](https://docs.veriko.mx/en/playground-and-testing): The API has no test host and no simulation flag in the body — what consumes quota, what does not, where a call runs without effects, and how to build reproducible cases.
- [Quick start](https://docs.veriko.mx/en/quick-start): Your first request to the API — validate a SPEI transfer and read the result.
- [JavaScript SDK](https://docs.veriko.mx/en/sdk-javascript): The official client for Node and TypeScript: install it, validate a SPEI transfer and verify a webhook signature.
- [Python SDK](https://docs.veriko.mx/en/sdk-python): The official client for Python: install it, validate a SPEI transfer and verify a webhook signature.
- [Security and data handling](https://docs.veriko.mx/en/security-and-compliance): What is stored for every validation, how the key is protected, how webhooks are signed, how images are sanitized, and how long each datum lives.
- [Get the Banxico service status (public view)](https://docs.veriko.mx/en/v1/banxico-status/banxico-public-status): Returns the current operational status of the Banxico validation service, derived from periodic health checks.
- [Banxico health time series (public view)](https://docs.veriko.mx/en/v1/banxico-status/banxico-public-timeseries): Returns the historical operational status of the Banxico validation service, bucketed by time interval for the requested metric and window.
- [Cancel an import job](https://docs.veriko.mx/en/v1/beneficiaries/cancel-beneficiary-import): Cancels an import job that has not been confirmed yet (pending, parsing or preview_ready).
- [Confirm the bulk import](https://docs.veriko.mx/en/v1/beneficiaries/commit-beneficiary-import): Confirms an import job and triggers the persistence of its rows into GET /v1/beneficiaries. The operation is asynchronous: the endpoint responds with HTTP status 202 and the import moves to committing while the worker processes the rows. GET /v1/beneficiaries/imports/{id} accepts polling until the state is completed or failed. Commit rules:
- [Start a bulk beneficiary import](https://docs.veriko.mx/en/v1/beneficiaries/create-beneficiary-import): Uploads a file — CSV, XLS, XLSX, TXT, JSON, or PDF, up to 20 MB — and opens an import job with it. XLSX/XLS sheets allow up to 10,000 rows and 64 columns. XLSX formulas are read as text without evaluation. PDFs allow up to 50 pages and cap decoded streams at 8 MiB. The reading mode decides how much work the file does and how much the server does:
- [Create a beneficiary](https://docs.veriko.mx/en/v1/beneficiaries/create-beneficiary): Registers a new beneficiary account. The account type is auto-detected from the number's length, and which fields the request sends follows from it:
- [Remove a preview row](https://docs.veriko.mx/en/v1/beneficiaries/delete-beneficiary-import-row): Removes a row from an owned import job before confirmation.
- [Archive a beneficiary](https://docs.veriko.mx/en/v1/beneficiaries/delete-beneficiary): Archives the beneficiary account. The record is not deleted: it leaves the active, visible list, and the historical validations referencing it stay intact, so archiving a beneficiary does not affect its validation history.
- [Download bulk import template](https://docs.veriko.mx/en/v1/beneficiaries/download-beneficiary-import-template): Returns a template file in the requested format, with the fixed headers alias, cuenta and banco and example rows for CLABE, card and DiMo phone. Serves as a starting point for the bulk import.
- [Export beneficiaries as CSV](https://docs.veriko.mx/en/v1/beneficiaries/export-beneficiaries): Downloads the beneficiary accounts of the authenticated account as a file, under the same with_archived filter as GET /v1/beneficiaries.
- [Preview extracted rows from import](https://docs.veriko.mx/en/v1/beneficiaries/get-beneficiary-import-preview): Returns the rows extracted from the file in an import job, paginated and filterable by bucket.
- [Get import job status](https://docs.veriko.mx/en/v1/beneficiaries/get-beneficiary-import): Returns the status of an import job and its per-bucket counters: valid, correctable, fatal, duplicate_account (summed in duplicate_count) and committed/skipped after the commit.
- [List beneficiaries](https://docs.veriko.mx/en/v1/beneficiaries/list-beneficiaries): Returns the beneficiary accounts saved under the authenticated account, unpaginated. The list gathers the three types the API recognises: CLABE, card, and phone (DiMo).
- [Look up account in own whitelist](https://docs.veriko.mx/en/v1/beneficiaries/lookup-beneficiary-account): Looks up an exact account number within the beneficiary list of the authenticated account. When it exists, the response carries the bank details.
- [Edit a preview row](https://docs.veriko.mx/en/v1/beneficiaries/patch-beneficiary-import-row): Allows a preview row to be corrected before the persistence of an import job is confirmed. Accepts a JSON:API envelope or a flat object. Every attribute is optional; only those present are overwritten.
- [Update a beneficiary](https://docs.veriko.mx/en/v1/beneficiaries/update-beneficiary): Updates an already registered beneficiary. The body accepts the JSON:API envelope or a flat object, and what is sent determines the scope of the change:
- [Validate account structure (CLABE, card, or phone)](https://docs.veriko.mx/en/v1/beneficiaries/validate-account): Checks the structure of an account number. The account type is detected from the length: CLABE (18 digits), card (16 digits), phone/DiMo (10 digits).
- [Get user's active subscription](https://docs.veriko.mx/en/v1/billing/billing-get-subscription): Returns the authenticated user's active subscription. The response always contains a resource: if no active subscription exists, the server assigns the default plan.
- [Get dashboard summary](https://docs.veriko.mx/en/v1/dashboard/get-dashboard-summary): Returns the user's aggregate counters: the lifetime total, the current UTC-month total, validations with verdict valid, the monthly count of the queued and processing states, the average amount, and the success rate. It also includes the active beneficiary count.
- [Request the CEP archive in the background](https://docs.veriko.mx/en/v1/finance/create-finance-cep-export): Queues the preparation of the CEP ZIP for a date range and responds immediately with an HTTP status 202. It is the asynchronous alternative to GET /v1/finance/ceps for large ranges: the archive is built in the background, without holding the connection open.
- [Download the archive of a CEP export](https://docs.veriko.mx/en/v1/finance/download-finance-cep-export): Delivers the ZIP of an asynchronous CEP export that is ready. It is the same archive as GET /v1/finance/ceps: the XML and PDF files under ceps/ and the manifest.csv and manifest.xlsx manifests.
- [Accounting export (CSV / XLSX / PDF · DD/MM/YYYY)](https://docs.veriko.mx/en/v1/finance/get-finance-accounting): Exports the same columns as the monthly verifications report (15 columns, SAT-compatible format), with dates in DD/MM/YYYY and a configurable decimal separator.
- [Bank summary (CSV / XLSX / PDF / preview)](https://docs.veriko.mx/en/v1/finance/get-finance-by-bank): Groups the month's verifications by receiving bank (banxico_code), with totals, valid count, success rate and total amount. It contains 6 columns:
- [Check the state of a CEP export](https://docs.veriko.mx/en/v1/finance/get-finance-cep-export): Returns the state of an asynchronous CEP export. While status is queued or building, poll again after a pause of a few seconds; ready, failed and expired are terminal.
- [Bulk CEP download (ZIP)](https://docs.veriko.mx/en/v1/finance/get-finance-ceps): Delivers every available CEP file in a date range as a single ZIP.
- [Counterparty summary (CSV / XLSX / PDF / preview)](https://docs.veriko.mx/en/v1/finance/get-finance-counterparties): Groups the month's verifications by beneficiary account and bank, and includes 7 columns:
- [Monthly validations report (CSV / XLSX / PDF / preview)](https://docs.veriko.mx/en/v1/finance/get-finance-monthly): Returns the listing (in SAT-compatible format) of the month's verifications in 15 columns:
- [Monthly statement (PDF / XLSX / CSV / HTML)](https://docs.veriko.mx/en/v1/finance/get-finance-statement): Generates the month's financial statement in four formats:
- [Monthly financial summary (KPIs)](https://docs.veriko.mx/en/v1/finance/get-finance-summary): Returns the month's KPIs for the /finanzas panel:
- [List recent CEP exports](https://docs.veriko.mx/en/v1/finance/list-finance-cep-exports): Returns the last 20 asynchronous CEP exports requested by the caller, newest first, with their state, size and expiry.
- [View the account's validation metrics](https://docs.veriko.mx/en/v1/insights/get-user-insights-overview): Returns the validation metrics for the authenticated user:
- [List the account's banks by validation volume or error rate](https://docs.veriko.mx/en/v1/insights/get-user-insights-top-banks): Lists the banks used in the authenticated user's validations over the last 30 days, ranked by total volume or by error rate.
- [List the most frequent beneficiaries in the account's validations](https://docs.veriko.mx/en/v1/insights/get-user-insights-top-beneficiaries): Lists the beneficiaries detected most frequently in the authenticated user's validations over the last 90 days.
- [Get the account's validation time series](https://docs.veriko.mx/en/v1/insights/get-user-insights-trends): Returns a time series representing the authenticated user's validations, according to the selected range and metric.
- [Get the plan comparison table](https://docs.veriko.mx/en/v1/plans/get-public-plan-comparison): Returns the /pricing “Compare plans” table as structured data.
- [Public plan catalog (landing)](https://docs.veriko.mx/en/v1/plans/list-public-plans): Returns the plan catalog for unauthenticated surfaces (the /pricing landing and embeddable widgets).
- [Get the calendar of SPEI non-business days for a year](https://docs.veriko.mx/en/v1/public/get-spei-calendar): Returns the calendar of SPEI non-business days for a year, with the official provision it comes from.
- [Codes and list of participant banks](https://docs.veriko.mx/en/v1/public/list-banks): Returns the current catalog of banking institutions participating in the SPEI system. The catalog is updated weekly from the official lists of the Bank of Mexico (Banxico).
- [Get the bank of a card](https://docs.veriko.mx/en/v1/public/lookup-bin): Resolves the issuing bank of a payment card from its BIN (Bank Identification Number).
- [Export API usage](https://docs.veriko.mx/en/v1/usage/export-api-usage): Downloads the authenticated user's API activity log.
- [Get API usage metrics](https://docs.veriko.mx/en/v1/usage/get-api-usage): Returns the authenticated user's API usage metrics:
- [Usage breakdown by operation](https://docs.veriko.mx/en/v1/usage/get-usage-breakdown): Breaks down the indicated period's usage by billable operation type (validation and sms_2fa).
- [Validation heatmap by day and hour](https://docs.veriko.mx/en/v1/usage/get-usage-heatmap): Returns the user's validations grouped by day of week and hour of day, over the last days days (max 90).
- [Monthly usage history](https://docs.veriko.mx/en/v1/usage/get-usage-history): Returns the authenticated user's monthly validation usage for up to months months with usage, most recent first. Months without usage are omitted.
- [User-visible rate limits](https://docs.veriko.mx/en/v1/usage/get-usage-limits): Returns the rate limits that apply to the authenticated user, by context.
- [Current monthly quota summary](https://docs.veriko.mx/en/v1/usage/get-usage-summary): Returns the validation quota of the plan assigned to the authenticated user:
- [Get default retry policy](https://docs.veriko.mx/en/v1/users/get-my-retry-policy): Returns the authenticated user's default retry policy.
- [Get the current user's complete information](https://docs.veriko.mx/en/v1/users/my-profile): Returns in a single call everything the application needs to know about the authenticated user:
- [Set default retry policy](https://docs.veriko.mx/en/v1/users/update-my-retry-policy): Sets the authenticated user's default retry policy. From the moment it is saved, it applies to every future validation that does not carry its own in the body.
- [Cancel pending retries](https://docs.veriko.mx/en/v1/validations/cancel-validation-retries): Cancels the active automatic retry cycle of a validation and returns terminal_state="cancelled".
- [Withdraw a validation](https://docs.veriko.mx/en/v1/validations/delete-validation): Withdraws a validation from the history through a soft delete.
- [Download the official CEP](https://docs.veriko.mx/en/v1/validations/download-cep): Downloads the Electronic Payment Receipt (CEP) issued by Banxico for a validation with a valid verdict, or returned when the CEP was downloaded before the return was known.
- [Execute the permanent deletion of a validation](https://docs.veriko.mx/en/v1/validations/execute-validation-purge): Permanently deletes the content of one of your own validations, with the token issued by POST /v1/validations/{id}/purge/prepare. It is the second step of a two-step flow: without that token nothing is deleted.
- [Export validations](https://docs.veriko.mx/en/v1/validations/export-validations): Downloads to a file the validations matching the filters.
- [Get the receipt image](https://docs.veriko.mx/en/v1/validations/get-validation-image): Returns the receipt kept for an OCR validation, with private caching:
- [Get a single validation](https://docs.veriko.mx/en/v1/validations/get-validation): Returns the complete record of a validation, with its verdict, the normalized data and the state of its retries.
- [List retry attempts](https://docs.veriko.mx/en/v1/validations/list-validation-retry-attempts): Returns the chronological history of a validation's automatic retries.
- [List validations](https://docs.veriko.mx/en/v1/validations/list-validations): Returns the paginated validation history of the authenticated account.
- [Prepare the permanent deletion of a validation](https://docs.veriko.mx/en/v1/validations/prepare-validation-purge): Describes what the permanent deletion of one of your own validations would delete and issues the token with which POST /v1/validations/{id}/purge/execute confirms it. It changes nothing: the validation and its files stay as they were.
- [Query the payment status of a validation again](https://docs.veriko.mx/en/v1/validations/recheck-validation): Queries Banxico again for the payment status of a valid validation and, if it reports the payment as returned, moves it to returned.
- [Send the CEP to Telegram](https://docs.veriko.mx/en/v1/validations/send-cep-to-telegram): Starts delivery of the CEP as a PDF to the Telegram chat linked to the owning account.
- [Configure retry policy](https://docs.veriko.mx/en/v1/validations/update-validation-retry-policy): Activates an automatic retry policy for a validation with a not_found, cep_unavailable or error verdict.
- [Manually validate a SPEI transfer](https://docs.veriko.mx/en/v1/validations/validate-direct): Validates a SPEI transfer against the Banxico CEP from the fields you send.
- [Validate a SPEI transfer (OCR)](https://docs.veriko.mx/en/v1/validations/validate-ocr): Validates a SPEI transfer from its receipt, as an image or a PDF. It extracts the data from the receipt through optical character recognition (OCR) and validates it against Banxico to obtain the transaction's CEP.
- [Get validation statistics for the account](https://docs.veriko.mx/en/v1/validations/validation-stats): Returns aggregate counters for the account's validations:
- [Create a webhook endpoint](https://docs.veriko.mx/en/v1/webhooks/create-webhook): Registers an HTTPS endpoint that will receive the subscribed events as webhooks. The URL must resolve to a public address: localhost and private ranges are rejected.
- [Delete a webhook endpoint](https://docs.veriko.mx/en/v1/webhooks/delete-webhook): Deletes the endpoint and its entire delivery history. Unlike almost everything else in this API, there is no archiving here: the record is gone and cannot be recovered.
- [Export all deliveries as CSV or XLSX](https://docs.veriko.mx/en/v1/webhooks/export-all-deliveries): Downloads the delivery history of every endpoint on the account as a file, under the same filters and text search (q) as the list.
- [Export endpoint deliveries as CSV or XLSX](https://docs.veriko.mx/en/v1/webhooks/export-webhook-deliveries): Downloads up to 100,000 records of a specific webhook endpoint's delivery history.\ Download formats: csv or xlsx.
- [List deliveries across all endpoints](https://docs.veriko.mx/en/v1/webhooks/list-all-deliveries): Consolidated view of the authenticated user's webhook deliveries, across all their endpoints at once.
- [List deliveries for an endpoint](https://docs.veriko.mx/en/v1/webhooks/list-webhook-deliveries): Returns the delivery attempts for a specific endpoint, from most recent to oldest, paginated.
- [List webhook endpoints](https://docs.veriko.mx/en/v1/webhooks/list-webhooks): Returns the authenticated user's registered webhook endpoints, each with its status, current data and the events it subscribes to.
- [Regenerate webhook signing secret](https://docs.veriko.mx/en/v1/webhooks/regenerate-webhook-secret): Rotates the secret used to sign this endpoint's delivery bodies. The new secret travels exactly once, in this response, and there is no way to read it again.
- [Send a test event to the webhook](https://docs.veriko.mx/en/v1/webhooks/send-webhook-test): Sends a synthetic delivery to the endpoint to check the receiver is standing. It is the natural next step after registering or updating an endpoint: it confirms the receiver answers with an HTTP 2xx status and validates the body signature.
- [Update a webhook endpoint](https://docs.veriko.mx/en/v1/webhooks/update-webhook): Updates the receiving address, the subscribed events, or the status of an already registered endpoint. Only what arrives in the body changes: an absent field stays as it was, and a body with no editable field responds with an HTTP 422 status (with no_valid_fields in the body).