API de listas del SAT

Qué consulta

• Anexo 69-B del CFF: contribuyentes que el SAT presume o define como operaciones simuladas (EFOS).
• Listas del Artículo 69 del CFF: créditos fiscales firmes y demás supuestos publicados por el SAT.
• Cada respuesta separa un hallazgo del 69-B de uno del Art. 69: no son lo mismo.

Planes y paquetes

Cada RFC consultado cuenta una vez, sea encontrado o no. Un plan mensual da un cupo de RFC que se renueva cada mes; un paquete prepagado se compra una vez y se gasta después del cupo mensual.

Cómo se usa

1. Pide una llave gratis en la página de la API (una por correo). Con el plan gratis tienes 50 RFC al mes.
2. Manda hasta 100 RFC por petición en un POST con tu llave en el encabezado Authorization.
3. Si el saldo no alcanza para toda la petición, se rechaza completa (402) y no se cobra nada a medias.

Hasta 100 RFC por petición y 60 peticiones por minuto por llave.

Ejemplo

Estos RFC de prueba son ficticios y reservados: devuelven respuestas fijas con cualquier llave válida y no se cobran.

curl -X POST https://herramientasfiscales.mx/api/v1/efos/check \
  -H "Authorization: Bearer af_tu_llave" \
  -H "Content-Type: application/json" \
  -d '{"rfcs": ["TST010101LIM", "TST010101DEF"]}'

{
  "consultadoEn": "2026-10-18T14:05:11-06:00",
  "fuentes": [
    { "lista": "69b", "filas": 14807, "cargadaEn": "2026-10-18T09:00:00-06:00", "corteSat": "2026-09-30" },
    { "lista": "firmes", "filas": 264337, "cargadaEn": "2026-10-18T09:01:00-06:00", "corteSat": null }
  ],
  "listasNoCargadas": [],
  "resultados": [
    { "rfc": "TST010101LIM", "encontrado": false, "prueba": true },
    {
      "rfc": "TST010101DEF", "encontrado": true, "prueba": true,
      "nombre": "EMPRESA DE PRUEBA DEFINITIVA SA DE CV",
      "anexo69b": {
        "situacion": "definitivo",
        "fases": {
          "presuncion": { "oficio": "PRUEBA-500-05-2020-0001", "fechaSat": "2020-02-10", "fechaDof": "2020-03-02" },
          "definitivo": { "oficio": "PRUEBA-500-05-2020-0003", "fechaSat": "2020-11-20", "fechaDof": "2020-12-04" }
        }
      }
    }
  ],
  "errors": [],
  "consumo": { "rfcsCobrados": 0, "saldoMensual": 50, "saldoPrepago": 0, "renueva": "2026-11-01T00:00:00-06:00", "proximoVencimientoPrepago": null }
}

La respuesta real trae el mismo esquema. El campo consumo dice lo cobrado en esa petición: con los RFC de prueba, rfcsCobrados es 0.

Errores comunes: 401 INVALID_KEY, 402 SALDO_INSUFICIENTE, 429, 503 LISTAS_NO_DISPONIBLES. Referencia completa en la documentación.

Contrato formal para generar tu cliente: OpenAPI 3.1 (JSON).