Check a Peruvian supplier before you pay it
Send a company tax ID (RUC) and get back what SUNAT, Peru's tax authority, has on file: the legal name, whether the company is still active, and whether SUNAT could verify its fiscal address. Each answer ends in a verdict to pass, review or stop the payment, with the reasons in English.
- For accounts-payable and procurement teams in the U.S. that pay or onboard suppliers in Peru.
- For developers building AI agents that vet vendors, through a REST API or a remote MCP server.
Try a RUC
Type an 11-digit Peruvian tax ID. Company RUCs start with 20.
The verdict, status and fiscal address appear here.
This box uses the no-key allowance: 10 lookups a day per network.
What the verdict means
Two SUNAT fields decide most payments: the taxpayer status and the fiscal-address condition. A company can be deregistered, or flagged NO HABIDO because SUNAT could not find it at its address, and still send you invoices.
Active with SUNAT and the fiscal address is verified (HABIDO).
Active but the address is not verified, activities are suspended, or the RUC is newer than our latest copy of the registry. A person should look before paying.
The check digit is wrong, or the company is deregistered, annulled or disabled. Invoices from it may not hold up for tax purposes.
Three steps to your first lookup
Get a key
Send your work email. The key comes back right away and allows 100 lookups a day.
curl -X POST https://taxid.halpii.com/v1/keys \
-H "content-type: application/json" \
-d '{"email":"you@company.com"}'Call the REST API
One GET per RUC. The JSON includes assessment.verdict and the date of the registry copy.
curl https://taxid.halpii.com/v1/pe/ruc/20100047218 \
-H "Authorization: Bearer $KEY"Or connect your agent
Add the remote MCP server (Streamable HTTP). Your agent gets the validate_peru_ruc tool.
{
"mcpServers": {
"peru-ruc": {
"url": "https://taxid.halpii.com/mcp",
"headers": { "Authorization": "Bearer KEY" }
}
}
}Pricing
Both plans return every field, over REST and MCP.
Free key
- Full company data for RUCs that start with 20
- Usage report at
/v1/usage - The count resets at 00:00 UTC; after 100 you get HTTP 429 until then
- No card needed
Pay as you go Coming soon
- No daily cap
- Billed monthly for the lookups you made
- Need more than 100 a day before it opens? Write to contacto@halpii.com
Without a key you can make 10 lookups a day per network, for trying the API.
Countries
Each country gets the same response shape and its own MCP tool.
- PeruRUC, check digit and SUNAT registryAvailable
- MexicoRFCPlanned
- ColombiaNITPlanned
- ArgentinaCUITPlanned
- BrazilCNPJPlanned
Tell us which country you need first: contacto@halpii.com
Questions
Where does the data come from?
From the Padrón Reducido del RUC, the registry file that SUNAT publishes for public download. It lists every RUC with its name, status, fiscal-address condition and address. We add district names from INEI location codes.
How often is it updated?
SUNAT publishes a new file every day and we reload it from there. Every response carries source.data_as_of, the date of the copy it came from. A company registered after that date comes back as not found, with a review verdict.
What about RUCs that belong to individuals?
RUCs that start with 10, 15, 16 or 17 belong to natural persons. For those we only confirm that the number and its check digit are valid, and return no name or address, in line with Peru's Personal Data Protection Law (Ley 29733). Some older company RUCs (starting with 20) are registered under a person's name. For those we return the status, address condition and district, and withhold the name and street address. Anyone can ask us to withhold their data at contacto@halpii.com.
Are you affiliated with SUNAT?
No. This is an independent service run by HALPII S.A.C., a company registered in Lima. SUNAT does not endorse or operate it.
Can I rely on the verdict?
Use it as a first check. The results come from SUNAT's public file as of the date shown and are informational. They are not legal or tax advice. For a payment that matters, confirm on SUNAT's own lookup at e-consultaruc.sunat.gob.pe. The service is provided as is, and to the extent the law allows, HALPII S.A.C. is not liable for decisions made from its results.