> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SENIAT: Registro de Información Fiscal (RIF)

> Consulta un contribuyente venezolano por RIF en el registro del SENIAT: nombre, actividad económica, condición frente al IVA y porcentaje de retención.

Consulta un contribuyente en el Registro de Información Fiscal (RIF) del SENIAT, la
administración tributaria de Venezuela: personas, empresas y entes públicos, con el
porcentaje de retención de IVA que un agente de retención debe aplicarles.

`POST /ve/seniat/rif/v1` [Live](https://docs.usecroma.com/es/live-lookups.md)

| Campo | Tipo | Notas |
| - | - | - |
| `rif` | string | **Obligatorio.** La letra del tipo (`V` persona, `E` extranjero, `J` empresa, `P` pasaporte, `G` gobierno, `C` comunal) y nueve dígitos, el último el verificador. `J-00124134-5` y `J001241345` son lo mismo. |

```bash theme={"dark"}
curl https://api.croma.run/ve/seniat/rif/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rif": "J001241345" }'
```

| Campo | Notas |
| - | - |
| `found` | `false` cuando el registro no tiene un contribuyente con ese RIF. Un dígito verificador errado se lee igual que un número desconocido. |
| `rif` | El RIF consultado, en mayúsculas y sin separadores. |
| `name` | El nombre registrado del contribuyente. |
| `trade_name` | La denominación comercial que aparece entre paréntesis tras el nombre, o `null`. |
| `economic_activity` | La actividad económica registrada, o `null` cuando el registro no tiene ninguna. |
| `vat_condition` | La condición frente al IVA, p. ej. "Contribuyente Ordinario del IVA y Agente de Retención del IVA". `null` cuando no aparece. |
| `vat_withholding_rate` | El porcentaje del IVA que un agente de retención le retiene a este contribuyente: `75` o `100`. |
| `vat_withholding_note` | La frase de retención del registro, textual. |
| `personal_firms[]` | Las firmas personales registradas a nombre del contribuyente. Vacío cuando no tiene. |
| `message` | La respuesta completa del registro en texto plano. |

> [card] [Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.