Referencia de la API

Leer y verificar una Constancia de Situación Fiscal

Envía el PDF de una Constancia de Situación Fiscal o su QR y recibe el domicilio fiscal, los regímenes, las actividades económicas y la fecha de emisión, cada uno verificado con el SAT.

POST /v1/csf/verify

Lee una Constancia de Situación Fiscal (CSF) y la verifica con el SAT. Envía el PDF y recibe el domicilio fiscal, los regímenes fiscales, las actividades económicas, las obligaciones fiscales y la fecha de inicio de operaciones que imprime, la confirmación del SAT de cuándo se emitió la constancia, y los datos del contribuyente como los tiene hoy el SAT. Termina en unos 2 segundos.

Un PDF no prueba nada por sí solo: es fácil de editar, y uno auténtico queda desactualizado cuando el contribuyente se muda o cambia de régimen. Por eso nada del archivo se da por bueno. Los dos códigos QR de la constancia son las preguntas que el SAT responde: el de la primera página devuelve el registro vigente del contribuyente, y el que está junto al sello devuelve el momento en que el SAT emitió el documento. Lo que imprime el archivo se compara después con esas respuestas.

Úsalo para dar de alta a un cliente o proveedor a partir de la constancia que envía, para aplicar una regla como "emitida en los últimos 3 meses" con la fecha del SAT en lugar de la impresa, o para actualizar un domicilio fiscal guardado solo con el QR.

Cuerpo de la solicitud

Envía una de estas opciones: el archivo, el texto del QR, o rfc con id_cif. Una solicitud que las mezcla se rechaza con 422.

Campo Tipo Requerido Descripción
file archivo o string Para leer una constancia La constancia, subida como archivo (multipart/form-data) o enviada en base64 en un cuerpo JSON. El PDF que generó el SAT es el que más da: su texto se lee y se compara con el SAT. De una imagen PNG o JPEG, o de un PDF escaneado, solo se leen los códigos QR. Hasta 8 MB.
qr string o arreglo En lugar del archivo El texto de un código QR impreso en la constancia (una URL de siat.sat.gob.mx), o un arreglo con ambos. El QR de la primera página devuelve al contribuyente; el QR del sello devuelve la fecha de emisión.
rfc string Con id_cif El RFC del contribuyente.
id_cif string Con rfc El idCIF impreso bajo el nombre del contribuyente en la primera página. Junto con el RFC es lo que lleva el QR de la primera página.

Pruébalo

POST /v1/csf/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
o

Solicitud de ejemplo: el PDF

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

También funciona un cuerpo JSON, con el archivo en base64: {"file": "JVBERi0xLjQK..."}. Se acepta el prefijo de una URL data:.

Solicitud de ejemplo: el QR o el idCIF

curl bash
curl -X POST https://rfccheck.com/v1/csf/verify \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "rfc": "ACME010101AAA",
    "id_cif": "10010100002"
  }'

Respuesta (200)

200 OK json
{
  "rfc": "ACME010101AAA",
  "id_cif": "10010100002",
  "found": true,
  "message": "SAT issued this constancia and its data matches SAT's current record.",
  "taxpayer": {
    "person_type": "moral",
    "name": "ACME CONSULTORES",
    "capital_regime": "SA DE CV",
    "incorporation_date": "2001-01-01",
    "start_date": "2001-01-01",
    "status": "ACTIVO",
    "status_date": "2001-01-01",
    "address": {
      "zip": "06600",
      "street_type": "CALLE",
      "street": "AVENIDA DE EJEMPLO",
      "exterior_number": "200",
      "interior_number": null,
      "neighborhood": "COLONIA DE EJEMPLO",
      "municipality": "CUAUHTEMOC",
      "state": "CIUDAD DE MEXICO",
      "tax_office": "CIUDAD DE MEXICO 1"
    },
    "regimes": [
      {
        "name": "Régimen General de Ley Personas Morales",
        "start_date": "2001-01-01",
        "end_date": null
      }
    ]
  },
  "document": {
    "issuance": "verified",
    "issued_at": "2026-10-16T08:45:15",
    "issued_in": "CUAUHTEMOC, CIUDAD DE MEXICO",
    "age_days": 30,
    "matches_sat": true,
    "differences": [],
    "alert": null,
    "data": {
      "person_type": "moral",
      "name": "ACME CONSULTORES",
      "trade_name": "ACME",
      "capital_regime": "SOCIEDAD ANONIMA DE CAPITAL VARIABLE",
      "start_date": "2001-01-01",
      "status": "ACTIVO",
      "status_date": "2001-01-01",
      "address": {
        "zip": "06600",
        "street_type": "CALLE",
        "street": "AVENIDA DE EJEMPLO",
        "exterior_number": "200",
        "interior_number": null,
        "neighborhood": "COLONIA DE EJEMPLO",
        "locality": "CUAUHTEMOC",
        "municipality": "CUAUHTEMOC",
        "state": "CIUDAD DE MEXICO",
        "between_street": "CALLE UNO",
        "and_street": "CALLE DOS"
      },
      "economic_activities": [
        {
          "order": 1,
          "activity": "Servicios de consultoría en computación",
          "percentage": 100,
          "start_date": "2001-01-01",
          "end_date": null
        }
      ],
      "regimes": [
        {
          "name": "Régimen General de Ley Personas Morales",
          "start_date": "2001-01-01",
          "end_date": null
        }
      ],
      "obligations": [
        {
          "description": "Pago definitivo mensual de IVA.",
          "due": "A más tardar el día 17 del mes inmediato posterior al periodo que corresponda.",
          "start_date": "2001-01-01",
          "end_date": null
        }
      ]
    }
  }
}

taxpayer: el registro vigente del SAT

taxpayer es lo que el SAT responde hoy para el idCIF y el RFC, diga lo que diga el archivo: identidad, fecha de inicio de operaciones (start_date), estatus en el padrón, domicilio fiscal y regímenes vigentes. Las fechas van en ISO 8601; los demás valores son el texto del SAT. Es null cuando found no es true, o cuando solo se envió un QR del sello.

Una persona física tiene curp, names, paternal_surname, mothers_maiden_name y birthdate. Una persona moral tiene en su lugar capital_regime e incorporation_date. Los campos que el contribuyente no tiene se omiten, no van en null. La respuesta en vivo del SAT no incluye las actividades económicas ni las obligaciones: esas vienen del archivo, en document.data.

Para ver qué estado, municipio y colonias cubre un código postal, usa /geo/zip en MexCheck, con esta misma API key.

document: la constancia que enviaste

document está presente cuando enviaste un archivo o un QR del sello; si no, es null.

Campo Descripción
issuance verified: el SAT confirma que emitió una constancia con este sello. rejected: el SAT dice que no, o el sello es de otro contribuyente. not_verifiable: la constancia es anterior a la verificación en línea del sello del SAT (el QR de su sello no trae folio), o el archivo no tiene QR del sello. null: no se pudo consultar al SAT sobre el sello.
issued_at Cuándo se emitió la constancia, en hora de la Ciudad de México. Es el registro del propio SAT cuando issuance es verified; si no, lo que dice la constancia, que un archivo editado puede falsear. Las constancias antiguas traen la fecha sin la hora.
issued_in El lugar de emisión que imprime la constancia. Null si no hay un PDF legible.
age_days Días desde issued_at hasta hoy en la Ciudad de México.
data Lo que imprime el archivo, con la misma forma que taxpayer más trade_name, la localidad y las entrecalles del domicilio, economic_activities (con el porcentaje y las fechas de cada una), regimes con sus fechas de fin y obligations (cada declaración o pago que el contribuyente debe presentar, con su vencimiento). Null para una imagen o un PDF escaneado.
matches_sat Si data coincide con el registro vigente del SAT. Null cuando no hay data o no hay taxpayer con qué comparar.
differences Los campos que no coinciden, como address.zip, regimes o issued_at. Una diferencia significa que el contribuyente cambió ese dato después de que se emitió la constancia, o que el archivo fue editado: en ambos casos, confía en taxpayer.
alert El veredicto sobre el archivo: edited, outdated_or_edited, o null cuando no hay nada mal o no hubo nada que comparar. Ve más abajo.

Lo que solo trae el archivo: actividades y obligaciones

document.data trae dos tablas que la respuesta en vivo del SAT no incluye. Ambas se leen del texto del PDF, así que no vienen en una foto o un escaneo, y el SAT no puede confirmarlas: una edición en cualquiera de ellas pasa desapercibida.

economic_activities

Campo Descripción
order El número de orden que el SAT da a la actividad.
activity La actividad, en palabras del SAT.
percentage Su participación en los ingresos del contribuyente, de 0 a 100.
start_date Cuándo dio de alta la actividad el contribuyente.
end_date Cuándo terminó. Null mientras siga vigente.

obligations

Las declaraciones y pagos que el contribuyente debe presentar, como el IVA mensual o las retenciones por sueldos. Se derivan de los regímenes y las actividades, y te dicen qué debería poder comprobar un proveedor que ha presentado.

Campo Descripción
description La obligación, en palabras del SAT.
due Cuándo vence, en palabras del SAT. Es una regla (el día 17 del mes siguiente), no una fecha.
start_date Cuándo comenzó la obligación.
end_date Cuándo terminó. Null mientras siga vigente.

Cuando el archivo y el SAT no coinciden

matches_sat es false cuando algo de lo que imprime el archivo difiere de la respuesta del SAT. La comparación cubre el nombre, la CURP, la fecha de inicio de operaciones, la situación y su fecha, cada parte del domicilio fiscal y los regímenes vigentes con sus fechas de alta. También revisa que el RFC y el idCIF del texto sean los del código QR, y que las fechas que indica el archivo sean la fecha de emisión. Se ignoran acentos, mayúsculas y espacios.

alert convierte esa comparación, y la respuesta del SAT sobre el sello, en un veredicto:

  • edited: el SAT respondió que no emitió una constancia con ese sello, o differences trae rfc, id_cif, issued_at, curp o start_date. Esos datos no cambian después de emitida una constancia, así que el archivo fue editado o armado a partir de otro documento. Recházalo.
  • outdated_or_edited: differences trae solo campos de address, regimes, status, status_date o name. El contribuyente pudo haberlos cambiado desde entonces, o el archivo fue editado. age_days los distingue: una constancia emitida hace días que ya no coincide con el SAT amerita una revisión de fraude, mientras que una antigua lo más probable es que esté desactualizada. Pide una constancia nueva.

En ambos casos, taxpayer es el dato que debes conservar. Un alert en null no prueba que el archivo esté intacto. Las actividades económicas, las obligaciones, el nombre comercial y el correo no forman parte de la respuesta del SAT, así que nunca se comparan y una edición en ellos pasa desapercibida. Y cuando issuance es not_verifiable, el SAT no pudo confirmar la fecha de emisión.

found

found Significado
true El SAT tiene una constancia para ese idCIF y RFC, y taxpayer trae su registro vigente. Revisa document.issuance y document.matches_sat antes de confiar en el archivo.
false El SAT respondió que el idCIF y el RFC no corresponden a nada que haya emitido. message trae la explicación del propio SAT, en español.
null No se pudo contactar al validador del SAT. Reintenta más tarde.

Otras respuestas

Toda respuesta del SAT regresa como un 200 con los mismos campos. Estas son las que difieren del ejemplo anterior. Omiten taxpayer y document.data, que conservan la forma que se muestra ahí.

La constancia está desactualizada o fue editada

El archivo imprime un domicilio que el SAT ya no tiene. taxpayer trae el vigente.

200 OK json
{
  "rfc": "ACME010101AAA",
  "id_cif": "10010100002",
  "found": true,
  "message": "SAT has this taxpayer, but the constancia differs from SAT's current record: it is out of date or was edited. See document.differences.",
  "document": {
    "issuance": "verified",
    "issued_at": "2025-12-16T08:45:15",
    "issued_in": "CUAUHTEMOC, CIUDAD DE MEXICO",
    "age_days": 334,
    "matches_sat": false,
    "differences": ["address.zip", "address.street"],
    "alert": "outdated_or_edited"
  }
}

La constancia fue editada

El SAT tiene al contribuyente, pero respondió que no emitió ninguna constancia con ese sello. La misma alerta llega con un sello verificado cuando differences trae un campo que no puede cambiar después de la emisión, como start_date.

200 OK json
{
  "rfc": "ACME010101AAA",
  "id_cif": "10010100002",
  "found": true,
  "message": "SAT has this taxpayer, but did not issue a constancia with this seal.",
  "document": {
    "issuance": "rejected",
    "issued_at": "2025-12-16T08:45:15",
    "issued_in": "CUAUHTEMOC, CIUDAD DE MEXICO",
    "age_days": 334,
    "matches_sat": true,
    "differences": [],
    "alert": "edited"
  }
}

Una constancia antigua, cuya fecha de emisión el SAT no puede confirmar

Los datos sí se compararon con el registro actual del SAT. issued_at es lo que indica el archivo, y no trae hora.

200 OK json
{
  "rfc": "PEMJ800101AB3",
  "id_cif": "10010100001",
  "found": true,
  "message": "The constancia's data matches SAT's current record. SAT cannot confirm when it was issued: see document.issuance.",
  "document": {
    "issuance": "not_verifiable",
    "issued_at": "2025-03-04",
    "issued_in": "CUAUHTEMOC, CIUDAD DE MEXICO",
    "age_days": 621,
    "matches_sat": true,
    "differences": [],
    "alert": null
  }
}

El SAT no tiene una constancia para ese idCIF y RFC

Se cobra, porque el SAT respondió. message es el texto del propio SAT.

200 OK json
{
  "rfc": "ACME010101AAA",
  "id_cif": "10010100002",
  "found": false,
  "message": "Al RFC: ACME010101AAA no se le ha emitido su Cédula de identificación fiscal",
  "taxpayer": null,
  "document": null
}

No se pudo consultar al SAT

No se cobra. document trae de todos modos lo que se leyó del archivo, con issuance en null. Reintenta más tarde.

200 OK json
{
  "rfc": "ACME010101AAA",
  "id_cif": "10010100002",
  "found": null,
  "message": "SAT's constancia validator is temporarily unavailable. Please retry.",
  "taxpayer": null,
  "document": {
    "issuance": null,
    "issued_at": "2025-12-16T08:45:15",
    "issued_in": "CUAUHTEMOC, CIUDAD DE MEXICO",
    "age_days": 334,
    "matches_sat": null,
    "differences": [],
    "alert": null
  }
}

Facturación

Cada solicitud cuesta 5 créditos. Las respuestas con found: null y los errores 422 no se cobran. Una respuesta found: false sí se cobra, porque el SAT respondió la pregunta que hiciste.

Errores

Los campos faltantes, mezclados o mal formados se rechazan con 422 invalid_fields, que lista cada campo por corregir. Un archivo que no es un PDF ni una imagen, o que no trae un código QR de constancia, se rechaza igual, con file.

422 json
{
  "error": "invalid_fields",
  "fields": ["file"]
}