costa-rica-hacienda

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[], each { estado, tipo, codigo, descripcion }. estado: "A" = active; tipo: "P" marks the primary activity (others secondary); codigo is a Costa Rica CIIU-derived activity code (e.g. "6020.0") with its Spanish descripcion.

Hacienda data is Costa Rican public government data. Read-only, Spanish-language throughout.

What this does NOT give you

• No directors, shareholders, or personeria. Who owns or legally represents the company lives in the Registro Nacional, a separate registry that is largely paid and web-only - it is not in this endpoint. This API is name + tax standing + economic activity only.
• No name search. The endpoint is ID-keyed only - you must already have the cedula juridica. There is no free lookup-by-name here.