Referencia de la API

Verifica un recibo de luz de CFE

Envía un recibo de CFE como PDF o foto y obtén la copia que tiene CFE: el titular, el domicilio del servicio y si el archivo fue editado.

POST /v1/cfe/verify

Verifica un recibo de luz de CFE, el comprobante de domicilio habitual en México, con la propia CFE. CFE confirma que el número de servicio, el nombre del titular y el total a pagar corresponden entre sí, y entrega su propia copia del recibo, que leemos y comparamos con el archivo que enviaste.

Úsalo para dar de alta a un cliente desde su recibo, para tomar el domicilio de CFE y no de un archivo, y para detectar un recibo editado. Un PDF no prueba nada por sí solo: cualquiera puede cambiarle el nombre o el domicilio.

Precios: 50 créditos por cada recibo que CFE responde, lo confirme o no: $0.75 en pago por uso, y menos con un plan, cuyos créditos cuestan menos. No se cobra nada cuando no se puede consultar a CFE.

Cuerpo de la solicitud

Envía el recibo como archivo, o los tres valores que CFE verifica. Con un archivo, cualquiera de los tres valores que también envíes reemplaza lo que se leyó de él.

Campo Tipo Descripción
file archivo o cadena base64 El recibo: el PDF que entrega CFE, un escaneo o una foto (PNG o JPEG). Súbelo como multipart/form-data, o envíalo en base64 dentro del JSON; se acepta el prefijo data: URL. Hasta 8 MB.
service_number string El número de servicio de 12 dígitos (No. de servicio) impreso en el recibo.
name string El nombre del titular exactamente como lo imprime el recibo, recortado si el recibo lo recorta.
total integer El total a pagar en pesos enteros, como está impreso: 63 para $63.

PDF, escaneo o foto

El PDF que entregan el portal y la app de CFE trae su texto, así que se lee cada uno de sus campos y se compara con la copia de CFE. Ese es el archivo que conviene pedirle a tu cliente.

Una foto, o un escaneo guardado como PDF, se lee de dos maneras. El código de barras del talón de pago, al pie, da el número de servicio, la fecha límite y el monto sin errores, así que tiene que salir en la imagen. El nombre del titular y el domicilio se leen por OCR, con los errores que el OCR comete en una mala imagen.

CFE verifica el nombre que se le envía, así que un nombre mal leído por el OCR regresa como found: false. Si ya tienes el nombre del titular, envíalo como name junto con el archivo. Cuando el nombre no se puede leer y no se envió ninguno, la solicitud se rechaza con fields ["name"] y no se cobra.

Pruébalo

POST /v1/cfe/verify
Pruébalo

Inicia sesión para enviar una solicitud real desde esta página.

Las cuentas nuevas reciben $5 USD de crédito al registrarse, sin tarjeta.

o

Solicitud de ejemplo: el archivo

curl bash
curl -X POST https://mexcheck.com/v1/cfe/verify \
  -H "x-api-key: rfc_your_api_key" \
  -F [email protected]

Solicitud de ejemplo: los tres valores

curl bash
curl -X POST https://mexcheck.com/v1/cfe/verify \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"service_number": "123456789012", "name": "JUAN PEREZ LOPEZ", "total": 63}'

Respuesta (200)

200 OK json
{
  "service_number": "123456789012",
  "found": true,
  "mismatch": null,
  "message": "CFE issued this receipt, and the file matches CFE's copy.",
  "receipt": {
    "service_number": "123456789012",
    "name": "JUAN PEREZ LOPEZ",
    "address": [
      "AV. SIEMPRE VIVA 742",
      "ENTRE UNO Y DOS",
      "COL. CENTRO &C.P.64000",
      "MONTERREY, N.L.,N.L."
    ],
    "address_parts": {
      "street": "AV. SIEMPRE VIVA 742",
      "between_street": "ENTRE UNO Y DOS",
      "neighborhood": "COL. CENTRO",
      "zip": "64000",
      "city": "MONTERREY",
      "municipality": "Monterrey",
      "municipality_code": "039",
      "state": "Nuevo León",
      "state_code": "19"
    },
    "zip": "64000",
    "total": 63,
    "due_date": "2026-11-16",
    "period_start": "2026-08-28",
    "period_end": "2026-10-29",
    "tariff": "1C",
    "meter": "ZZZ000",
    "account": "01DD00A000000000"
  },
  "document": {
    "source": "pdf",
    "age_days": 0,
    "same_receipt": true,
    "compared": [
      "service_number", "name", "address", "zip", "total", "due_date",
      "period_start", "period_end", "tariff", "meter", "account"
    ],
    "matches_cfe": true,
    "differences": [],
    "alert": null,
    "data": {
      "service_number": "123456789012",
      "name": "JUAN PEREZ LOPEZ",
      "address": [
        "AV. SIEMPRE VIVA 742",
        "ENTRE UNO Y DOS",
        "COL. CENTRO &C.P.64000",
        "MONTERREY, N.L.,N.L."
      ],
      "zip": "64000",
      "total": 63,
      "due_date": "2026-11-16",
      "period_start": "2026-08-28",
      "period_end": "2026-10-29",
      "tariff": "1C",
      "meter": "ZZZ000",
      "account": "01DD00A000000000"
    }
  }
}

found

Valor Significado Se cobra
true CFE confirma que el número de servicio, el nombre del titular y el total a pagar corresponden entre sí. Sí
false CFE dice que no: el servicio no existe, o el nombre o el monto no es el de sus registros. message trae las palabras de CFE. Sí
null No se pudo consultar a CFE. Intenta más tarde. No

Cuando CFE rechaza: mismatch

Cuando found es false, mismatch nombra el valor que CFE rechazó, y message trae las palabras de CFE.

mismatch Significado
"name" El nombre del titular no es el que CFE tiene para ese servicio. En una foto, revisa primero si el OCR lo leyó mal: document.data.name muestra lo que se envió.
"total" El monto no es el de los dos últimos recibos del servicio. CFE no confirma recibos más antiguos, así que un recibo auténtico de hace meses se rechaza de la misma forma.
null La respuesta de CFE no nombra ninguno, como cuando no conoce el número de servicio.

Para distinguir un recibo antiguo de uno falso, revisa document.age_days, los días desde que venció el recibo. Cuando CFE rechaza el monto de un recibo que venció hace más de 120 días, message dice que puede ser auténtico y demasiado antiguo para verificarse. Pídele a tu cliente un recibo reciente.

200 OK json
{
  "service_number": "123456789012",
  "found": false,
  "mismatch": "total",
  "message": "El total a pagar no coincide con nuestro registro, favor de validar la información con su último o penúltimo recibo. (This receipt fell due 364 days ago. CFE only confirms a service's last two receipts, so it may be genuine and too old to check: ask for a recent one.)",
  "receipt": null,
  "document": {
    "source": "pdf",
    "age_days": 364,
    "same_receipt": null,
    "compared": [],
    "matches_cfe": null,
    "differences": [],
    "alert": null,
    "data": {"service_number": "123456789012", "total": 61, "due_date": "2025-11-17", "...": "..."}
  }
}

receipt: la copia de CFE

Lo que imprime la copia del recibo que tiene CFE: el titular, el domicilio del servicio en líneas con su código postal aparte, el total a pagar, la fecha límite, el periodo facturado, la tarifa, el medidor y la cuenta. Es el recibo del mes del archivo que enviaste cuando CFE aún lo lista; si no, el más reciente. Este es el domicilio que conviene guardar.

address es el domicilio como lo imprime el recibo, línea por línea. address_parts es el mismo domicilio tomado del registro del recibo que tiene CFE, en campos separados: street (con su número), between_street, neighborhood (la colonia), zip, city (la población, como la escribe CFE) y municipality_code, la clave INEGI del municipio dentro de su estado. municipality, state y state_code se llenan desde nuestro catálogo de códigos postales cuando tiene ese código postal en ese municipio; si no, state es la abreviatura de CFE y los otros dos son null.

Los dos vienen de dos archivos de CFE, y cualquiera puede faltar: address_parts es null cuando CFE no entregó su registro, y address es null cuando solo se pudo leer el registro. El registro de CFE escribe las letras acentuadas y la Ñ como signo de interrogación; devolvemos la letra desde el recibo impreso cuando lo tenemos.

document: el archivo que enviaste

Presente cuando se envió un archivo; null en otro caso.

Campo Descripción
source "pdf" para el PDF de CFE, leído completo desde su texto. "photo" para una foto o un escaneo, leído desde su código de barras y por OCR.
age_days Días desde que venció el recibo, en el calendario de la Ciudad de México. Negativo mientras no ha vencido.
data Lo que imprime el archivo, en los campos de receipt. Para una foto solo se leen el número de servicio, la fecha límite, el monto, el titular y el domicilio; lo demás es null.
same_receipt Si la copia de CFE es el mismo recibo que el archivo: el mismo periodo facturado para un PDF, la misma fecha límite para una foto.
compared Los campos comparados con la copia de CFE. Todos los campos para un PDF del mismo recibo; el número de servicio, titular, domicilio y código postal cuando la copia de CFE es otro recibo; el número de servicio, monto y fecha límite del código de barras para una foto.
matches_cfe, differences Si los campos comparados coinciden con la copia de CFE, y los nombres de los que no.
alert "edited" cuando el archivo difiere de la copia de CFE del mismo recibo. "outdated_or_edited" cuando difiere de otro recibo del servicio, cuyo titular pudo haber cambiado desde entonces. null cuando nada difiere.

El titular y el domicilio de una foto no se comparan, porque el OCR no es lo bastante seguro para llamar editado a un archivo. Para una foto, tómalos de receipt.

Un recibo editado

El domicilio de este PDF fue cambiado. CFE aún confirma el servicio, porque su número, titular y monto no se tocaron, y su propia copia muestra la diferencia.

200 OK json
{
  "service_number": "123456789012",
  "found": true,
  "message": "CFE issued a receipt for this service, but the file differs from CFE's copy of it.",
  "receipt": {
    "name": "JUAN PEREZ LOPEZ",
    "address": ["AV. SIEMPRE VIVA 742", "ENTRE UNO Y DOS", "COL. CENTRO &C.P.64000", "MONTERREY, N.L.,N.L."],
    "...": "..."
  },
  "document": {
    "source": "pdf",
    "same_receipt": true,
    "matches_cfe": false,
    "differences": ["address"],
    "alert": "edited",
    "data": {
      "name": "JUAN PEREZ LOPEZ",
      "address": ["AV. SIEMPRE VIVA 999", "ENTRE UNO Y DOS", "COL. CENTRO &C.P.64000", "MONTERREY, N.L.,N.L."],
      "...": "..."
    }
  }
}

Errores

Una solicitud que no se puede verificar devuelve 422 con error invalid_fields y fields con lo que falta o es inválido, y no se cobra: ["file"] para un archivo que no es un recibo de CFE, o una foto sin su código de barras de pago; ["name"] para una foto cuyo titular no se pudo leer; los valores mismos cuando un número de servicio no tiene 12 dígitos o un total no está en pesos enteros. Consulta la página de errores para los códigos que comparten todos los endpoints.