Nullable = the authority may not publish this value; it is then null. Authority-sourced: yes = copied from the register, derived = computed by Registralia from register values (documented).
Ecuador — SRI RUC record
| Field | Type | Nullable | Authority-sourced | Description | Example |
|---|---|---|---|---|---|
ruc | string | no | yes | Ecuadorian tax ID (RUC), 13 digits: 10-digit cedula or company number, province prefix, plus establishment suffix. | "1791251237001" |
country | string | no | derived | ISO 3166-1 alpha-2 country code. Always 'EC' for this source. | "EC" |
countryName | string | no | derived | Country name in English. | "Ecuador" |
legalName | string | yes | yes | Registered legal name (razon social) exactly as the SRI holds it. | "CORPORACION FAVORITA C.A." |
taxpayerType | string | yes | yes | Normalised taxpayer type: 'company' or 'natural_person'. Unmapped SRI values pass through verbatim. | "company" |
rucType | string | no | derived | RUC shape as validated locally: company or natural person. | "company" |
status | string | yes | yes | Normalised status: 'active', 'suspended' or 'inactive'. An unmapped SRI value passes through verbatim rather than being forced into one of the three. | "active" |
statusOriginal | string | yes | yes | The SRI's own Spanish status string, unmodified, so a customer can audit the mapping. | "ACTIVO" |
suspensionReason | null | yes | yes | Authority's stated reason for cancellation or suspension. | null |
mainEconomicActivity | string | yes | yes | Principal economic activity as described by the SRI. | "VENTA AL POR MENOR EN COMERCIOS NO ESPECIALIZADOS CON PREDO… |
taxRegime | string | yes | yes | Tax regime (e.g. GENERAL, RIMPE). | "GENERAL" |
taxCategory | null | yes | yes | Taxpayer category where the SRI assigns one. | null |
activityStartDate | string | yes | yes | Date activities began, ISO 8601 (YYYY-MM-DD). | "1957-05-06" |
activityEndDate | null | yes | yes | Date activities ceased, ISO 8601. Null means no cessation is recorded. | null |
activityRestartDate | null | yes | yes | Date activities restarted, ISO 8601. | null |
registryUpdatedAt | string | yes | yes | Date the SRI last updated this record, ISO 8601. Use this to judge freshness at source. | "2025-03-11" |
mustKeepAccounting | boolean | yes | yes | Whether the taxpayer is legally obliged to keep formal accounts. | true |
isWithholdingAgent | boolean | yes | yes | Whether the taxpayer is a designated withholding agent. | true |
isSpecialTaxpayer | boolean | yes | yes | Whether the SRI classifies the taxpayer as 'contribuyente especial'. | true |
isGhostTaxpayer | boolean | yes | yes | OFFICIAL RISK FLAG. The SRI has designated this taxpayer a 'contribuyente fantasma' - registered but without real economic activity. A state finding, not our inference. | false |
hasNonExistentTransactions | boolean | yes | yes | OFFICIAL RISK FLAG. The SRI has recorded 'transacciones inexistentes' against this taxpayer. | false |
legalRepresentatives | array | no | yes | Array of {identification, name} for each legal representative published by the SRI. | [{"identification": "1704331234", "name": "REPRESENTANTE LEG… |
headOfficeAddress | string | yes | derived | Full address of the head office (matriz), taken from the establishment list. | "PICHINCHA / QUITO / IÑAQUITO / AV. GENERAL ENRIQUEZ" |
establishmentCount | integer | no | derived | Total number of registered establishments. | 2 |
openEstablishmentCount | integer | no | derived | Number of establishments currently open. | 1 |
establishments | array | no | yes | Array of establishments: number, commercialName, type, isHeadOffice, status (open/closed), fullAddress, plus province, canton, parish and street split out. | [{"number": "001", "commercialName": "MATRIZ", "type": "MAT"… |
source | string | no | derived | Human-readable name of the issuing authority. | "SRI — Servicio de Rentas Internas del Ecuador" |
sourceUrl | string | no | derived | Deep link to the authority's own public record, so any field can be verified at source. | "https://srienlinea.sri.gob.ec/sri-en-linea/SriRucWeb/Consul… |
scrapedAt | string | no | derived | UTC timestamp of retrieval, ISO 8601. | "2026-09-10T15:02:30.525Z" |
rucChecksumValid | boolean | no | derived | Whether the RUC passed its official checksum locally. False means the identifier itself is malformed. | true |
Costa Rica — Hacienda taxpayer record
| Field | Type | Nullable | Authority-sourced | Description | Example |
|---|---|---|---|---|---|
identification | string | no | yes | Costa Rican identifier, digits only: cedula juridica (companies) or cedula fisica (natural persons). | "3101000109" |
identificationType | string | no | derived | 'cedula_juridica' or 'cedula_fisica'. | "cedula_juridica" |
country | string | no | derived | ISO 3166-1 alpha-2 code. Always 'CR' for this source. | "CR" |
legalName | string | yes | yes | Registered name exactly as Hacienda holds it, trimmed of the registry's own padding. | "EMPRESA EJEMPLO SOCIEDAD ANONIMA" |
entityType | string | yes | derived | Entity class derived from the identifier structure, e.g. company, foundation, association. | "company" |
juridicalClass | string | yes | derived | Finer legal form from the cedula prefix: 3-101 sociedad anonima, 3-102 SRL, 3-109 fundacion, 3-110 asociacion. | "sociedad_anonima" |
status | string | yes | yes | Normalised status: 'registered', 'deregistered' or 'not_registered'. Hacienda publishes no closed list, so an unrecognised value passes through verbatim and nothing downstream is inferred from it. | "registered" |
statusOriginal | string | yes | yes | Hacienda's own Spanish status string, unmodified (e.g. 'Inscrito', 'Inscrito de Oficio', 'Desinscrito oficio'). | "Inscrito" |
canIssueElectronicInvoice | boolean | yes | derived | Whether the taxpayer may issue factura electronica. True only for a registered taxpayer; null when the status is unrecognised. | true |
isExOfficio | boolean | yes | yes | Whether the taxpayer was registered or deregistered by the authority rather than voluntarily ('de oficio'). Not itself a risk flag. | false |
isTaxDelinquent | boolean | yes | yes | OFFICIAL RISK FLAG. Hacienda's 'moroso' designation: the taxpayer owes tax. A state finding, not our inference. | false |
isNonFiler | boolean | yes | yes | OFFICIAL RISK FLAG. Hacienda's 'omiso' designation: the taxpayer failed to file returns. | false |
riskFlagsRaised | array | no | derived | Array naming every flag that is explicitly true. Empty when none is raised. | [] |
hasRiskFlag | boolean | yes | derived | True if any flag is raised, false only when the authority explicitly cleared the taxpayer, null when the authority published no flag at all. See the Null semantics sheet. | false |
taxRegime | string | yes | yes | Tax regime description. | "Régimen General" |
taxRegimeCode | integer | yes | yes | Numeric regime code as issued by Hacienda. | 1 |
taxOffice | string | yes | yes | Administracion tributaria responsible for the taxpayer. | "SAN JOSE" |
mainActivity | string | yes | yes | Description of the primary economic activity. | "Programación informática" |
mainActivityCode | string | yes | yes | Official code of the primary economic activity. | "620100" |
activityCount | integer | no | derived | Number of economic activities on record. | 2 |
activities | array | no | yes | Array of {code, description, type (primary/secondary), status (active/inactive)}. | [{"code": "620100", "description": "Programación informática… |
source | string | no | derived | Human-readable name of the issuing authority. | "Ministerio de Hacienda de Costa Rica" |
sourceUrl | string | no | derived | Deep link to the authority's own public record. | "https://api.hacienda.go.cr/fe/ae?identificacion=3101000109" |
scrapedAt | string | no | derived | UTC timestamp of retrieval, ISO 8601. | "2026-09-10T15:02:30.546Z" |