# LatAm Datos API – Peru RUC Validator

> LatAm Datos API – Peru RUC Validator is a paid API for AI agents from latam-datos-api.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Validates a Peruvian RUC (tax ID) number and returns its type (persona natural or juridica) and validity status

## Facts

- Endpoint: GET https://latam-datos-api.onrender.com/pe/validar/ruc
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/latam-datos-api-peru-ruc-validator-c2f5a8bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3YXJEw4m2A-SybNC6Re_9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability latam-datos-api-peru-ruc-validator-c2f5a8bc
```

Example prompt: Can you check whether the Peruvian RUC 20100070970 is valid and tell me if it belongs to a company or an individual?

## When to prefer this

Use this endpoint when you need to programmatically verify a Peruvian RUC number for KYC, vendor onboarding, invoice validation, or compliance workflows, especially within an agent pipeline that handles LatAm emerging market data. It is the right choice over generic web search when you need a structured, machine-readable validity verdict and entity classification.

## Known failure modes

- Invalid or malformed RUC (not 11 digits) returns a validation error or valido:false
- Network timeout from the Render.com hosted service under cold-start conditions
- Missing 'valor' query parameter returns a 400 bad request
- RUC not found in registry returns valido:false
- Payment failure via x402 blocks the request before processing

## How this service works

Datos de mercados emergentes para agentes: FX LatAm, inflacion, tasas de bancos centrales, feriados, validacion de IDs fiscales/bancarios, IVA y salarios minimos. Pago por consulta via x402 v2 (USDC en Base).

## Output

A JSON object with two fields: 'valido' (boolean indicating whether the RUC is valid) and 'tipo' (string classifying the entity as 'persona natural' or 'persona juridica').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "valor"
     ],
     "properties": {
      "valor": {
       "type": "string",
       "description": "RUC de 11 digitos"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tipo": "persona juridica",
  "valido": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/latam-datos-api-peru-ruc-validator-c2f5a8bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from latam-datos-api.onrender.com](https://www.zero.xyz/host/latam-datos-api.onrender.com/llms.txt)