SAT1 tokenPOST

Certificados de Persona Física

Consulta los certificados digitales que un contribuyente persona física tiene registrados ante el SAT a partir de su RFC. Devuelve, por cada certificado, su número de serie, tipo (FIEL o SELLO), estado (Activo, Revocado o Caduco) y su periodo de vigencia.

Endpoint

POSThttps://api.datosnonstop.com/v1/sat/certificados-persona-fisica

Parámetros

json

{
  "rfc": "MAMA900119U24"
}

ParámetroTipoRequeridoDescripción

rfcstringSíRFC de la persona física cuyos certificados se desean consultar (exactamente 13 caracteres).

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.datosnonstop.com/v1/sat/certificados-persona-fisica \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"MAMA900119U24"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON

200 OK

{
  "id": "63b5c073cd0f651ec4322403",
  "status": "found",
  "rfc": "MAMA900119U24",
  "certificados": [
    {
      "numeroSerie": "00001000000511706145",
      "tipo": "FIEL",
      "estado": "Activo",
      "fechaInicio": "2022-03-02T05:04:08Z",
      "fechaFin": "2026-03-02T05:04:48Z"
    },
    {
      "numeroSerie": "00001000000401234567",
      "tipo": "SELLO",
      "estado": "Revocado",
      "fechaInicio": "2020-01-01T00:00:00Z",
      "fechaFin": "2024-01-01T00:00:00Z",
      "error": "El certificado no está disponible debido a su antigüedad."
    }
  ]
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "rfc"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

rfcstringRFC de la persona física. Exactamente 13 caracteres: 4 letras, 6 dígitos de fecha y 3 de homoclave.

Campos de respuesta

CampoTipoDescripción

idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.

statusstringResultado de la consulta de certificados en el SAT. Ver catálogo Status.

rfcstringRFC consultado (13 caracteres).

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.

certificadosarrayLista de certificados registrados ante el SAT para el RFC. Solo está presente cuando status es found.

certificados[].numeroSeriestringNúmero de serie del certificado asignado por el SAT.

certificados[].tipostringTipo de certificado. Ver catálogo Tipo.

certificados[].estadostringEstado actual del certificado ante el SAT. Ver catálogo Estado.

certificados[].fechaIniciostringInicio de vigencia del certificado en formato RFC3339.

certificados[].fechaFinstringFin de vigencia del certificado en formato RFC3339.

certificados[].errorstringDetalle cuando un certificado no pudo recuperarse por completo. Solo está presente en los certificados que reportan un problema.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción

foundEl SAT tiene certificados registrados para el RFC. La respuesta incluye el arreglo certificados.

not_foundEl SAT no tiene certificados registrados para el RFC. La respuesta incluye el campo message.

Tipo

Valores posibles del campo certificados[].tipo.

ValorDescripción

FIELCertificado de la e.firma (Firma Electrónica Avanzada) del contribuyente.

SELLOCertificado de Sello Digital (CSD) usado para timbrar CFDI.

Estado

Valores posibles del campo certificados[].estado.

ValorDescripción

ActivoEl certificado está vigente y puede utilizarse.

RevocadoEl certificado fue revocado ante el SAT y ya no es válido.

CaducoEl certificado expiró al alcanzar su fecha de fin de vigencia.

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/sat/certificados-persona-fisica

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl -X POST https://sandbox.api.datosnonstop.com/v1/sat/certificados-persona-fisica \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"MAMA900119U24"}'

Casos de prueba

Si envías un valor que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de MAMA900119U24.

CasoCamporfc

Caso exitoso — EncontradorfcMAMA900119U24

Caso exitoso — No encontradorfcXAXX010101000

Sin tokensrfcSINX010101SN1

Error internorfcERRX010101ER1

Unavailable servicerfcUNAX010101UN1

Empezar gratis →