Sample output

Exactly what the API returns — including how gaps in the source are represented.

Ecuador — SRI (registered company)

{
  "ruc": "1791251237001",
  "country": "EC",
  "countryName": "Ecuador",
  "legalName": "CORPORACION FAVORITA C.A.",
  "taxpayerType": "company",
  "rucType": "company",
  "status": "active",
  "statusOriginal": "ACTIVO",
  "suspensionReason": null,
  "mainEconomicActivity": "VENTA AL POR MENOR EN COMERCIOS NO ESPECIALIZADOS CON PREDOMINIO DE ALIMENTOS.",
  "taxRegime": "GENERAL",
  "taxCategory": null,
  "activityStartDate": "1957-05-06",
  "activityEndDate": null,
  "activityRestartDate": null,
  "registryUpdatedAt": "2025-03-11",
  "mustKeepAccounting": true,
  "isWithholdingAgent": true,
  "isSpecialTaxpayer": true,
  "isGhostTaxpayer": false,
  "hasNonExistentTransactions": false,
  "legalRepresentatives": [
    {
      "identification": "1704331234",
      "name": "REPRESENTANTE LEGAL EJEMPLO"
    }
  ],
  "headOfficeAddress": "PICHINCHA / QUITO / IÑAQUITO / AV. GENERAL ENRIQUEZ",
  "establishmentCount": 2,
  "openEstablishmentCount": 1,
  "establishments": [
    {
      "number": "001",
      "commercialName": "MATRIZ",
      "type": "MAT",
      "isHeadOffice": true,
      "status": "open",
      "fullAddress": "PICHINCHA / QUITO / IÑAQUITO / AV. GENERAL ENRIQUEZ",
      "province": "PICHINCHA",
      "canton": "QUITO",
      "parish": "IÑAQUITO",
      "street": "AV. GENERAL ENRIQUEZ"
    },
    {
      "number": "002",
      "commercialName": "SUCURSAL NORTE",
      "type": "SUC",
      "isHeadOffice": false,
      "status": "closed",
      "fullAddress": "GUAYAS / GUAYAQUIL / TARQUI / AV. FRANCISCO DE ORELLANA",
      "province": "GUAYAS",
      "canton": "GUAYAQUIL",
      "parish": "TARQUI",
      "street": "AV. FRANCISCO DE ORELLANA"
    }
  ],
  "source": "SRI — Servicio de Rentas Internas del Ecuador",
  "sourceUrl": "https://srienlinea.sri.gob.ec/sri-en-linea/SriRucWeb/ConsultaRuc/Consultas/consultaRuc?ruc=1791251237001",
  "scrapedAt": "2026-09-10T15:02:30.525Z",
  "rucChecksumValid": true
}

Costa Rica — Hacienda (three cases)

Registered with clean flags · ex officio with flags raised · not published by the authority (nulls).

[
  {
    "identification": "3101000109",
    "identificationType": "cedula_juridica",
    "country": "CR",
    "legalName": "EMPRESA EJEMPLO SOCIEDAD ANONIMA",
    "entityType": "company",
    "juridicalClass": "sociedad_anonima",
    "status": "registered",
    "statusOriginal": "Inscrito",
    "canIssueElectronicInvoice": true,
    "isExOfficio": false,
    "isTaxDelinquent": false,
    "isNonFiler": false,
    "riskFlagsRaised": [],
    "hasRiskFlag": false,
    "taxRegime": "Régimen General",
    "taxRegimeCode": 1,
    "taxOffice": "SAN JOSE",
    "mainActivity": "Programación informática",
    "mainActivityCode": "620100",
    "activityCount": 2,
    "activities": [
      {
        "code": "620100",
        "description": "Programación informática",
        "type": "primary",
        "status": "active"
      },
      {
        "code": "631101",
        "description": "Procesamiento de datos y hospedaje",
        "type": "secondary",
        "status": "active"
      }
    ],
    "source": "Ministerio de Hacienda de Costa Rica",
    "sourceUrl": "https://api.hacienda.go.cr/fe/ae?identificacion=3101000109",
    "scrapedAt": "2026-09-10T15:02:30.546Z"
  },
  {
    "identification": "3102000110",
    "identificationType": "cedula_juridica",
    "country": "CR",
    "legalName": "OTRA EMPRESA EJEMPLO S.R.L.",
    "entityType": "company",
    "juridicalClass": "sociedad_responsabilidad_limitada",
    "status": "registered",
    "statusOriginal": "Inscrito de Oficio",
    "canIssueElectronicInvoice": true,
    "isExOfficio": true,
    "isTaxDelinquent": true,
    "isNonFiler": true,
    "riskFlagsRaised": [
      "taxDelinquent",
      "nonFiler"
    ],
    "hasRiskFlag": true,
    "taxRegime": "Régimen General",
    "taxRegimeCode": 1,
    "taxOffice": "ALAJUELA",
    "mainActivity": "Venta al por menor en comercios no especializados",
    "mainActivityCode": "471100",
    "activityCount": 1,
    "activities": [
      {
        "code": "471100",
        "description": "Venta al por menor en comercios no especializados",
        "type": "primary",
        "status": "active"
      }
    ],
    "source": "Ministerio de Hacienda de Costa Rica",
    "sourceUrl": "https://api.hacienda.go.cr/fe/ae?identificacion=3102000110",
    "scrapedAt": "2026-09-10T15:02:30.546Z"
  },
  {
    "identification": "3109000111",
    "identificationType": "cedula_juridica",
    "country": "CR",
    "legalName": "FUNDACION EJEMPLO",
    "entityType": "foundation",
    "juridicalClass": "fundacion",
    "status": "Estado no publicado por la autoridad",
    "statusOriginal": "Estado no publicado por la autoridad",
    "canIssueElectronicInvoice": null,
    "isExOfficio": false,
    "isTaxDelinquent": null,
    "isNonFiler": null,
    "riskFlagsRaised": [],
    "hasRiskFlag": null,
    "taxRegime": null,
    "taxRegimeCode": null,
    "taxOffice": null,
    "mainActivity": null,
    "mainActivityCode": null,
    "activityCount": 0,
    "activities": [],
    "source": "Ministerio de Hacienda de Costa Rica",
    "sourceUrl": "https://api.hacienda.go.cr/fe/ae?identificacion=3109000111",
    "scrapedAt": "2026-09-10T15:02:30.546Z"
  }
]

Sample records use real registry structure with example identifiers; personal names of legal representatives are placeholders.