---
url: https://docs.consultaunica.mx/services/sat/tax_payer_search.md
description: >-
  Busca el nombre fiscal de un contribuyente ante Hacienda a partir de su RFC,
  tanto para persona física como para persona moral.
---

# 🏢 Servicio de búsqueda de contribuyente

* Método: `POST`
* URL de Consumo: `https://api.consultaunica.mx/v3/sat`
* Compra de paquetes: <https://consultaunica.mx/paquetes>

> 🧪 **¿Todavía sin créditos?** Prueba este servicio en `POST /v3/mock/sat`, con el mismo contrato y sin cargo. Ver [ambiente de pruebas](../mock.md).

## Ejemplo de consumo

### Persona física

```bash
curl -X POST https://api.consultaunica.mx/v3/sat \
  -H 'x-api-key: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f' \
  -H 'Content-Type: application/json' \
  -d '{
    "variant": "tax_payer_search",
    "taxPayerSearch": {
      "rfc": "LOOA531113FI5"
    }
  }'
```

### Persona moral

```bash
curl -X POST https://api.consultaunica.mx/v3/sat \
  -H 'x-api-key: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f' \
  -H 'Content-Type: application/json' \
  -d '{
    "variant": "tax_payer_search",
    "taxPayerSearch": {
      "rfc": "COP920428Q20"
    }
  }'
```

## ✅ Respuesta exitosa. HTTP 200

### Persona física encontrada

```json
{
    "variant": "tax_payer_search",
    "taxPayerSearch": {
        "entityType": "individual",
        "individual": {
            "name": "ANDRES MANUEL",
            "paternalName": "LOPEZ",
            "maternalName": "OBRADOR"
        }
    }
}
```

### Persona moral encontrada

```json
{
    "variant": "tax_payer_search",
    "taxPayerSearch": {
        "entityType": "company",
        "company": {
            "name": "COPPEL"
        }
    }
}
```

::: tip Toda respuesta de error trae también `description` y `errorCode`
Los ejemplos que muestran solo `message` los omiten; revisa la [estructura de las respuestas de error](../../start/index.md#estructura-de-las-respuestas-de-error).
:::

## ❌ Error de validación. HTTP 409

El RFC tiene un formato inválido

```json
{
    "message": "Datos inválidos, favor de verificar la información ingresada",
    "description": "Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.",
    "errorCode": "bad_request",
    "errors": [
        {
            "field": "body.taxPayerSearch.rfc",
            "error": "String should have at most 13 characters"
        }
    ]
}
```

## ❌ Error desconocido. HTTP 500

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