Peru SUNAT RUC Taxpayer Records

Quick Start

Look up Peruvian taxpayers in official public registry data. Designed for company verification, compliance research, and business enrichment. Paste this input to start:

{"ruc": "20131312955"}

Input

Field	Type	Default	What it does
ruc	string	""	11-digit taxpayer lookup.
companyName	string	""	Company-name fragment search.
maxResults	integer	30	Maximum name-search records.
includeDetails	boolean	true	Include full registry details for name matches.
requestDelaySecs	number	1	Delay between detail requests.

Provide exactly one of ruc or companyName.

Output

Each item includes ruc, companyKey, razonSocial, estado, condicion, domicilioFiscal, actividadEconomica, tipoContribuyente, nombreComercial, fechaInscripcion, fechaInicioActividades, ubicacion, matchType, sourceQuery, source, and scrapedAt. A name-search row whose full registry detail could not be fetched keeps the search-card fields and adds detailError (the source message); it does not fail the run.

Every successful or labelled-empty run also writes a key-value OUTPUT summary (status, records, matchType, emptyReason, summaryLine). A recognised no-match is a labelled empty run: status is succeeded_empty with a clear emptyReason, no dataset rows are pushed, and the run exits successfully. Upstream errors and unrecognised or malformed answer pages still fail loudly instead of producing a silent empty dataset.

Example record:

{"ruc":"20131312955","companyKey":"e-consultaruc.sunat.gob.pe:20131312955","razonSocial":"EMPRESA EJEMPLO S.A.C.","estado":"ACTIVO","condicion":"HABIDO","matchType":"ruc","source":"e-consultaruc.sunat.gob.pe"}

FAQ

How fresh is the data? Each run queries the official taxpayer registry.

What lookup scopes are supported? Search by an 11-digit RUC or company-name fragment.

What happens when there is no match? When SUNAT positively answers that it found no taxpayer (its "NO REGISTRA" name answer or its "no es válido" RUC answer), the run is a labelled empty result: OUTPUT.status is succeeded_empty with a clear emptyReason, no dataset rows are pushed, and the run exits successfully. An upstream error or an unrecognised/malformed page that parses to zero still fails loudly, so an arbitrary parser zero is never reported as a genuine miss.

What happens when a field is not published? The field is returned as null rather than guessed.

Support

For questions or issues, contact Apify support from the Actor page.