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.

Esta verificación es un paso de un trabajo más grande. La guía de MexCheck los recorre todos: [Verificación de proveedores](https://mexcheck.com/es/soluciones/verificacion-de-proveedores).

## 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. |


## 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 file=@constancia.pdf
```

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`](https://mexcheck.com/es/docs/endpoints/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"]
}
```