What is this page? The complete list of fields our Actors return — one row per JSON key. It tells a developer, before spending anything, whether the data fits their system: what each field means, whether it can be empty, and whether the value comes straight from the authority or was derived by us.
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 |
taxDebtChecked | boolean | no | derived | Whether the SRI's public tax-debt service answered for this RUC. False means the debt fields below are unknown, not clean. | true |
hasFirmTaxDebt | boolean | yes | derived | OFFICIAL RISK FLAG (derived from an official amount). True when the SRI reports deuda firme — assessed, enforceable tax debt — greater than zero. | false |
firmTaxDebtUsd | number | yes | yes | Firm (enforceable) tax debt in US dollars as published by the SRI at the cut-off date. | 0 |
suspendedTaxDebtUsd | number | yes | yes | Tax debt under dispute or otherwise suspended, in US dollars. | 0 |
taxDebtCutoffDate | string | yes | yes | The SRI's own cut-off date for the debt figures, ISO 8601. | "2026-09-19" |
taxDebtCollectionOffice | string | yes | yes | Collection office (oficina de cobranzas) named by the SRI, where one is assigned. | null |
taxDebtDetails | object | yes | yes | Only with includeTaxDebtDetails: the SRI's itemised lists {firm, disputed, paymentPlan}, passed through unchanged. | null |
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" |
ccssDebtorListChecked | boolean | no | derived | Whether the CCSS list of largest social-security debtors was loaded for this run. false means the list could not be fetched, so the fields below carry no information. | true |
onCcssTopDebtorList | boolean | yes | yes | Whether this identification appears on the CCSS report Patronos más Morosos — the ten largest debtors per economic sector, published under art. 74 of the CCSS constitutive act. | true |
ccssDebtCrc | number | yes | yes | Social-security contributions owed, in Costa Rican colón, as published by the CCSS. | 442713551 |
ccssEconomicDivision | string | yes | yes | Economic sector under which the CCSS lists the employer. | "ACTIVIDAD PESCA" |
ccssCollectionStatus | string | yes | yes | Stage of collection the CCSS records for the debt. | "Cobro Administrativo" |
ccssListedName | string | yes | yes | Employer name as spelled on the CCSS list. It can differ from legalName at Hacienda — useful evidence in itself. | "TERRAPEZ SOCIEDAD ANONIMA" |
ccssListSourceUrl | string | yes | derived | The CCSS page the list is published on. | "https://www.ccss.sa.cr/morosidad" |
Panama — DGI electronic-invoicing record
Sources: the DGI's public registry of Facturadores Electrónicos, the DGI's published Listado de Morosos (tax delinquents), and the Registro Público's Consulta de Folios Suspendidos (suspended, dissolved, merged and closed folios). The registry lists taxpayers affiliated to Panama's mandatory e-invoicing system, not the complete RUC roll — a not_found means not affiliated, not non-existent. A RUC that is not affiliated but is on the delinquent list is returned as not_found together with the delinquency fields.
| Field | Type | Nullable | Authority-sourced | Description | Example |
|---|---|---|---|---|---|
query | string | no | derived | The input as given: a RUC or a company name. | "280-134-61098" |
queryType | string | no | derived | 'ruc' for an exact RUC match, 'name' for a name search. | "ruc" |
country | string | no | derived | ISO 3166-1 alpha-2 code. Always 'PA' for this source. | "PA" |
ruc | string | no | yes | Panamanian RUC exactly as the DGI displays it (without the DV check digits). | "280-134-61098" |
rucType | string | no | derived | 'company' for Registro Público folio formats, 'natural_person' for cédula-based or E-/N-/PE- formats, 'unknown' otherwise. | "company" |
legalName | string | yes | yes | Registered name exactly as the DGI holds it. | "BANCO GENERAL S A" |
isAffiliated | boolean | yes | yes | Whether the taxpayer is affiliated to Panama's electronic-invoicing system. | true |
isIssuingElectronicInvoices | boolean | yes | yes | Whether the taxpayer is actually issuing electronic invoices (emitiendo FE). | true |
invoicingMode | string | yes | derived | 'pac' (through an authorised provider) or 'free_invoicer' (the DGI's free tool); unmapped values pass through verbatim. | "pac" |
invoicingModeOriginal | string | yes | yes | The DGI's own Spanish label, unmodified. | "PAC" |
affiliationDate | string | yes | yes | Date of affiliation to electronic invoicing, ISO 8601. | "2023-11-02" |
commercialActivity | string | yes | yes | Registered commercial activity as described by the DGI. | "Servicios financieros, excepto seguros y fondos de pensiones" |
dgiDelinquentListChecked | boolean | no | derived | Whether the DGI's published list of tax delinquents (Listado de Morosos) could be loaded for this run. False means the delinquency fields below are unknown, not clean. | true |
onDgiDelinquentList | boolean | yes | yes | OFFICIAL RISK FLAG. The RUC appears on the DGI's published list of taxpayers with tax arrears older than twelve months (Resolución 201-10281). A state finding, not our inference. Matched by RUC only — the list carries no names. | false |
dgiDelinquentTotalUsd | number | yes | derived | Sum of the amounts the DGI lists against this RUC, in USD (balboa pegged 1:1). 0 when the RUC is not on the list. | 0 |
dgiDelinquentTaxes | array | yes | yes | One entry per tax type on the list: {tax, amountUsd}, with the DGI's own tax label (e.g. '202 - ITBMS', '101 - RENTA'). | [{"tax": "202 - ITBMS", "amountUsd": 887.03}] |
dgiDelinquentListDate | string | yes | yes | Publication date of the list edition used, ISO 8601, as served by the DGI. A taxpayer who settled after this date may still appear. | "2026-01-13" |
rpAnnotationChecked | boolean | no | derived | Whether the Registro Publico's Folios Suspendidos service answered for this RUC. False means the fields below are unknown, not clean. | true |
rpFolioStatus | string | yes | derived | OFFICIAL RISK FLAG. Normalised folio annotation: 'suspended' (almost always unpaid tasa unica), 'dissolved', 'merged', 'operations_closed', or 'none' when the registry holds no annotation. Unmapped values pass through verbatim. | "suspended" |
rpFolioStatusOriginal | string | yes | yes | The registry's own Spanish status string, unmodified (SUSPENDIDO, DISUELTO, FUSION, CIERRE DE OPERACIONES). | "SUSPENDIDO" |
rpFolio | string | yes | yes | Folio number (Numero de Folio Real) under which the company is registered. | "607790" |
rpRegistryType | string | yes | yes | Registry section, e.g. Mercantil. | "Mercantil" |
rpModule | string | yes | yes | Entity class as the registry files it: Sociedades Anonimas, Sociedades Extranjeras, and so on. | "Sociedades Anonimas" |
rpLegalName | string | yes | yes | Company name as the Registro Publico holds it. Compare with legalName from the DGI to spot divergences. | "GRUPO MIRCO,S.A." |
rpIncorporationDate | string | yes | yes | Date of incorporation as recorded by the registry, ISO 8601. | "2008-03-13" |
rpAnnotationDate | string | yes | yes | Date the annotation was entered on the folio, ISO 8601. | "2019-11-26" |
matchIndex | integer | yes | derived | Name searches only: position of this record within the result set. | 1 |
matchTotal | integer | yes | derived | Name searches only: total number of registrants matching the name. | 16 |
source | string | no | derived | Human-readable name of the issuing authority. | "DGI — Dirección General de Ingresos de Panamá, Facturadores Electrónicos" |
sourceUrl | string | no | derived | The DGI's public search page. | "https://dgi-fep.mef.gob.pa/Consultas/EmpresasEnFacturaElectronica" |
scrapedAt | string | no | derived | UTC timestamp of retrieval, ISO 8601. | "2026-09-19T10:32:34.000Z" |