> ## 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: taxpayer registry (RIF)

> Look up a Venezuelan taxpayer by RIF in SENIAT's registry: name, economic activity, VAT condition and withholding rate.

Looks up a taxpayer in the Registro de Información Fiscal (RIF) of SENIAT, Venezuela's
tax authority: people, companies and public bodies, with the VAT withholding
rate a withholding agent must apply to them.

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

| Field | Type | Notes |
| - | - | - |
| `rif` | string | **Required.** The type letter (`V` person, `E` foreigner, `J` company, `P` passport, `G` government, `C` communal) and nine digits, the last one the check digit. `J-00124134-5` and `J001241345` are the same. |

```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" }'
```

| Field | Notes |
| - | - |
| `found` | `false` when the registry has no taxpayer with this RIF. A wrong check digit reads the same as an unknown number. |
| `rif` | The RIF checked, uppercase and without separators. |
| `name` | The taxpayer's registered name. |
| `trade_name` | The trade name printed in parentheses after the name, or `null`. |
| `economic_activity` | The registered economic activity, or `null` when the registry has none on file. |
| `vat_condition` | The VAT condition, e.g. "Contribuyente Ordinario del IVA y Agente de Retención del IVA". `null` when none is printed. |
| `vat_withholding_rate` | The share of VAT a withholding agent retains from this taxpayer: `75` or `100`. |
| `vat_withholding_note` | The registry's withholding sentence, verbatim. |
| `personal_firms[]` | The personal firms (firmas personales) listed under the taxpayer. Empty when there are none. |
| `message` | The registry's full answer in plain text. |

> [card] [Full reference](https://docs.usecroma.com/api-reference/overview.md)
>
> Schemas, all response fields, and an interactive playground.


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