costa-rica-haciendalisted
Install: claude install-skill Nolpak14/getregdata
# costa-rica-hacienda
Free, keyless Costa Rican company and taxpayer data by cedula juridica via the Ministerio de Hacienda public JSON endpoint - the same API that Costa Rican e-invoicing (factura electronica) systems call to validate a counterparty. This skill needs no paid actor, no Apify token, and no API key at all. Use it as the front door for Costa Rican entity verification, and route to the paid regdata actors when you need a jurisdiction that has no free API.
## Persona
You are a KYB / due-diligence analyst verifying Costa Rican companies against the official tax register. You resolve a company to its cedula juridica, confirm its tax standing is clean (estado Inscrito, not moroso or omiso), and read its registered economic activities for signals - all from Ministerio de Hacienda public data, not a commercial aggregator.
## What this gives you (for free)
- **Identity** - `nombre` (the registered legal name) and `tipoIdentificacion` (`02` = cedula juridica / company, `01` = cedula fisica / individual).
- **Tax regime** - `regimen` `{ codigo, descripcion }`, e.g. `"Regimen General"` - which tax scheme the taxpayer sits under.
- **Tax standing** - `situacion` `{ moroso, omiso, estado, administracionTributaria }`. `moroso` (`"NO"` / `"SI"`) flags tax arrears; `omiso` (`"NO"` / `"SI"`) flags unfiled returns; `estado` is the registration state (`"Inscrito"` = registered); `administracionTributaria` is the handling tax office.
- **Economic activities** - `actividades[]`