🏢 Servicio de validación de contribuyente

• Método: POST
• URL de Consumo: https://consultaunica.mx/api/v3/sat
• Compra de paquetes: https://consultaunica.mx/#prices (opens new window)

Headers (requerido API Key)

{
  "x-api-key": "1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f"
}

Payload JSON de ejemplo (obligatorios)

El Payload es un object, a continuación un ejemplo:

{
    "variant": "tax_payer_validation",
    "taxPayerValidation": {
        "rfc": "LOOA531113FI5",
        "taxPayer": "ANDRES MANUEL LOPEZ OBRADOR",
        "zipCode": "06066"
    }
}

✅ Respuestas exitosas. HTTP 200

{
    "variant": "tax_payer_validation",
    "taxPayerValidation": {
        "rfc": "LOOA531113FI5",
        "taxPayer": "ANDRES MANUEL LOPEZ OBRADOR",
        "zipCode": "06066",
        "isValid": false
    }
}

❌ Error de validación. HTTP 409

El RFC y el código postal tienen un formato inválido

{
    "message": "La consulta no es válida, favor de verificar los datos ingresados",
    "errors": [
        {
            "field": "body.taxPayerValidation.rfc",
            "error": "String should have at most 13 characters"
        },
        {
            "field": "body.taxPayerValidation.zipCode",
            "error": "String should have at most 5 characters"
        }
    ]
}

❌ Error desconocido. HTTP 500

{
    "message": "Algo falló durante la consulta, favor de consultar nuevamente"
}