# Colombia Agent Toolkit

Pay-per-call Colombia utilities for AI agents. / Utilidades de pago por llamada sobre Colombia para agentes de IA.
Payment: x402, USDC on eip155:8453. No signup or API key. You are only charged when the response is HTTP 200.

## GET https://co.redtapeapi.com/v1/nit/validate  ($0.002)
Validate a Colombian NIT (Número de Identificación Tributaria) offline with the DIAN check-digit algorithm. Accepts 900170781, 900170781-7 or 9001707817. Does not prove DIAN registration. Stores and logs nothing.
ES: Valida un NIT colombiano sin conexión (dígito de verificación DIAN). No confirma inscripción en DIAN. No guarda ni registra nada.
Params: nit*

## GET https://co.redtapeapi.com/v1/company/search  ($0.005)
Search Colombian legal entities / ESAL in RUES by razón social substring (case-insensitive). Returns up to 10 matches. No natural-person search. Confecámaras open data, CC BY-SA 4.0.
ES: Busca personas jurídicas / ESAL en RUES por fragmento de razón social (máx. 10). Sin búsqueda de personas naturales.
Params: q*

## GET https://co.redtapeapi.com/v1/company/:nit/status  ($0.003)
Short RUES matrícula status for a NIT (estado, renovación, vigencia, activa?). Legal entities / ESAL only. Confecámaras open data, CC BY-SA 4.0.
ES: Estado breve de matrícula RUES para un NIT (estado, renovación, vigencia, activa?).
Params: {nit}

## GET https://co.redtapeapi.com/v1/company/:nit  ($0.005)
Look up a Colombian legal entity / ESAL in RUES open data by NIT: razón social, cámara de comercio, estado de matrícula, CIIU, fechas de matrícula/renovación. Only personas jurídicas (categoria 01). Natural-person fields are never returned. Source: Confecámaras RUES via datos.gov.co (CC BY-SA 4.0).
ES: Consulta una persona jurídica / ESAL en RUES por NIT (razón social, cámara, estado, CIIU, fechas). Solo categoría jurídica; sin datos de persona natural.
Params: {nit}

## GET https://co.redtapeapi.com/v1/dossier  ($0.008)
Short KYB-style dossier for a Colombian NIT: DIAN check digit + RUES juridica matches + verdict ok/review/fail from status, age and renewal signals. Not legal advice. Confecámaras open data, CC BY-SA 4.0.
ES: Dossier KYB breve: dígito DIAN + coincidencias RUES + veredicto ok/review/fail. No es asesoría.
Params: nit*

Data: Confecámaras — Registro Único Empresarial y Social (RUES), publicado en datos.gov.co (https://www.datos.gov.co/resource/c82u-588k.json). Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0). Legal entities / ESAL only; natural-person fields never returned. Not an official Confecámaras, RUES, DIAN or chamber of commerce service. Data: Confecámaras — Registro Único Empresarial y Social (RUES), publicado en datos.gov.co; Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0).

## Free tier / Plan gratis (20 calls/day per client, no payment / 20 llamadas/día por cliente, sin pago)
GET https://co.redtapeapi.com/free/v1/company/{nit}/status  (free twin of /v1/company/{nit}/status)
GET https://co.redtapeapi.com/free/v1/company/{nit}  (free twin of /v1/company/{nit})
Header X-Free-Remaining shows the calls left today (UTC). When it reaches 0 the free URL answers with the normal x402 402 challenge, so an x402 client can pay and retry. / Al agotarse devuelve el 402 normal de x402.
MCP server (Streamable HTTP): POST https://co.redtapeapi.com/mcp  tools: co_company_status, co_company_lookup (same free quota)
Unified MCP server for all RedTape toolkits (Spain, Mexico, Colombia; same free quotas): POST https://mcp.redtapeapi.com/mcp (registry name com.redtapeapi/redtape)
Free-tier status: https://co.redtapeapi.com/status/free-tier

Free: OpenAPI https://co.redtapeapi.com/openapi.json · x402 manifest https://co.redtapeapi.com/.well-known/x402 · Privacy https://co.redtapeapi.com/privacy

Sister APIs: Spain Agent Toolkit (Spain + EU): https://es.redtapeapi.com/llms.txt; Mexico Agent Toolkit (RFC / SAT 69-B): https://mx.redtapeapi.com/llms.txt