{"name":"pe_ruc_search","description":"Search SUNAT's published taxpayer register by company name (razon social) -- legal entities only (RUC prefix 20 and government offices); natural persons are excluded entirely and are never returned. Accent-insensitive substring match: every word of 3+ letters must appear in the name. Active registrations are listed before deregistered ones. Optionally restrict to a place with a ubigeo prefix (2 digits = department, e.g. \"15\" Lima; 4 = province; 6 = district). Returns RUC, name, status and address so you can pick the right one.","summary":"Search Peruvian companies by name in the SUNAT register, optionally by ubigeo.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Company name or part of it, e.g. \"BANCO DE CREDITO\" or \"alicorp\"."},"ubigeo":{"type":"string","description":"Optional ubigeo prefix: 2, 4 or 6 digits (e.g. \"15\" Lima department, \"150122\" Miraflores)."},"active_only":{"type":"boolean","description":"If true, return only registrations whose status is ACTIVO (default false: active first, then the rest)."},"limit":{"type":"number","description":"Maximum results (1-50, default 10)."}},"required":["name"],"examples":[{"name":"alicorp","ubigeo":"15","limit":3}]},"outputSchema":{"type":"object","additionalProperties":true,"properties":{"found":{"type":"boolean"},"reason":{"type":"string"},"query":{"type":"string"},"ubigeo":{"type":["string","null"]},"returned":{"type":"number"},"message":{"type":"string"},"hint":{"type":"string"},"results":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"ruc":{"type":"string"},"name":{"type":"string"},"holder_type":{"type":"string"},"holder_type_basis":{"type":"string"},"status":{"type":["string","null"]},"status_gloss":{"type":["string","null"]},"is_active":{"type":"boolean"},"domicile_condition":{"type":["string","null"]},"domicile_condition_gloss":{"type":["string","null"]},"check_digit_valid":{"type":"boolean"},"ubigeo":{"type":["string","null"]},"department_code":{"type":["string","null"]},"department":{"type":["string","null"]},"address":{"type":["string","null"]},"address_parts":{"type":"object","additionalProperties":true},"address_withheld":{"type":"string"}}}},"data_as_of":{"type":["string","null"]},"source":{"type":"string"}}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false,"idempotentHint":true,"cost":{"all":1}},"version":"v1.e7c9b907","disclosure":{"cost":{"credits":50,"usd":"$0.0050","category":"gov","plan":"basic","basis":"list"},"auth":{"shape":"keyless","detail":"No key required — open upstream, callable as-is."},"reliability":{"measured":true,"window_days":7,"synthetic":{"checks":9,"ok_pct":100,"last_checked_day":"2026-11-22"}}},"call":"POST https://gateway.pipeworx.io/v1/tools/pe_ruc_search"}