POST /ve/seniat/rif/v1 Live
Full reference
Schemas, all response fields, and an interactive playground.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Look up a Venezuelan taxpayer by RIF in SENIAT’s registry: name, economic activity, VAT condition and withholding rate.
POST /ve/seniat/rif/v1 Live
| 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. |
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. |