{"openapi":"3.1.0","info":{"title":"Colombia Agent Toolkit","version":"1.0.0","description":"Pay-per-call Colombia utilities for AI agents over x402 (USDC on Base). NIT check digit + RUES company lookup (legal entities / ESAL only). 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). Privacy: /privacy","x-guidance":"Use when a task involves a Colombian company NIT: validate the check digit, fetch RUES matrícula/CIIU/status, search by razón social, or get a short KYB dossier verdict. Charged only on HTTP 200."},"servers":[{"url":"https://co.redtapeapi.com"}],"externalDocs":{"description":"Privacy notice","url":"https://co.redtapeapi.com/privacy"},"paths":{"/v1/nit/validate":{"get":{"operationId":"nit_validate","summary":"Validate a Colombian NIT (Número de Identificación Tributaria) offline with the DIAN check-digit algorithm","description":"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.\n\nES: Valida un NIT colombiano sin conexión (dígito de verificación DIAN). No confirma inscripción en DIAN. No guarda ni registra nada.\n\nPrice: $0.002 USDC per successful call via x402 (eip155:8453). Failed calls (4xx/5xx) are never charged.","tags":["Colombia"],"parameters":[{"name":"nit","in":"query","required":true,"description":"NIT with or without check digit","schema":{"type":"string"},"example":"900170781-7"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"nit":"900170781","checkDigit":"7","valid":true,"checks":{"format":true,"checkDigit":true}}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required"},"503":{"description":"Upstream RUES unavailable (never charged, retryable)"}}}},"/v1/company/search":{"get":{"operationId":"company_search","summary":"Search Colombian legal entities / ESAL in RUES by razón social substring (case-insensitive)","description":"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.\n\nES: Busca personas jurídicas / ESAL en RUES por fragmento de razón social (máx. 10). Sin búsqueda de personas naturales.\n\nPrice: $0.005 USDC per successful call via x402 (eip155:8453). Failed calls (4xx/5xx) are never charged.","tags":["Colombia"],"parameters":[{"name":"q","in":"query","required":true,"description":"Razón social substring (min 3 chars)","schema":{"type":"string"},"example":"ESCANHER"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"q":"ESCANHER","count":1,"results":[{"razonSocial":"ESCANHER ABOGADOS SAS","nitFull":"900170781-7"}]}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required"},"503":{"description":"Upstream RUES unavailable (never charged, retryable)"}}}},"/v1/company/:nit/status":{"get":{"operationId":"company_nit_status","summary":"Short RUES matrícula status for a NIT (estado, renovación, vigencia, activa?)","description":"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.\n\nES: Estado breve de matrícula RUES para un NIT (estado, renovación, vigencia, activa?).\n\nPrice: $0.003 USDC per successful call via x402 (eip155:8453). Failed calls (4xx/5xx) are never charged.","tags":["Colombia"],"parameters":[{"name":"nit","in":"path","required":true,"description":"NIT","schema":{"type":"string"},"example":"900170781"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"found":true,"status":{"estadoMatricula":"ACTIVA","activa":true}}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required"},"503":{"description":"Upstream RUES unavailable (never charged, retryable)"}}}},"/v1/company/:nit":{"get":{"operationId":"company_nit","summary":"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","description":"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).\n\nES: 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.\n\nPrice: $0.005 USDC per successful call via x402 (eip155:8453). Failed calls (4xx/5xx) are never charged.","tags":["Colombia"],"parameters":[{"name":"nit","in":"path","required":true,"description":"NIT (digits; optional check digit)","schema":{"type":"string"},"example":"900170781"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"found":true,"company":{"razonSocial":"ESCANHER ABOGADOS SAS","nitFull":"900170781-7","estadoMatricula":"ACTIVA"}}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required"},"503":{"description":"Upstream RUES unavailable (never charged, retryable)"}}}},"/v1/dossier":{"get":{"operationId":"dossier","summary":"Short KYB-style dossier for a Colombian NIT: DIAN check digit + RUES juridica matches + verdict ok/review/fail from status, age and renewal signals","description":"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.\n\nES: Dossier KYB breve: dígito DIAN + coincidencias RUES + veredicto ok/review/fail. No es asesoría.\n\nPrice: $0.008 USDC per successful call via x402 (eip155:8453). Failed calls (4xx/5xx) are never charged.","tags":["Colombia"],"parameters":[{"name":"nit","in":"query","required":true,"description":"NIT with or without check digit","schema":{"type":"string"},"example":"900170781-7"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.008000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"nit":"900170781-7","verdict":"ok","issues":[]}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required"},"503":{"description":"Upstream RUES unavailable (never charged, retryable)"}}}},"/free/v1/company/{nit}/status":{"get":{"operationId":"free_company_nit_status","security":[],"summary":"Free tier (20/day per client): Short RUES matrícula status for a NIT (estado, renovación, vigencia, activa?)","description":"Same as GET /v1/company/{nit}/status, free for the first 20 calls per client per UTC day (all free routes together). Response header X-Free-Remaining shows what is left. When the quota is used up this URL returns the normal x402 402 challenge for the paid route ($0.003 USDC), so an x402 client can pay and retry.","tags":["Colombia","Free tier"],"parameters":[{"name":"nit","in":"path","required":true,"description":"NIT","schema":{"type":"string"},"example":"900170781"}],"responses":{"200":{"description":"Successful response (free)","content":{"application/json":{"schema":{"type":"object"},"example":{"found":true,"status":{"estadoMatricula":"ACTIVA","activa":true}}}}},"400":{"description":"Invalid input (does not use quota)"},"402":{"description":"Free quota used up: x402 Payment Required for the paid route"},"503":{"description":"Upstream RUES unavailable (quota refunded)"}}}},"/free/v1/company/{nit}":{"get":{"operationId":"free_company_nit","security":[],"summary":"Free tier (20/day per client): 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","description":"Same as GET /v1/company/{nit}, free for the first 20 calls per client per UTC day (all free routes together). Response header X-Free-Remaining shows what is left. When the quota is used up this URL returns the normal x402 402 challenge for the paid route ($0.005 USDC), so an x402 client can pay and retry.","tags":["Colombia","Free tier"],"parameters":[{"name":"nit","in":"path","required":true,"description":"NIT (digits; optional check digit)","schema":{"type":"string"},"example":"900170781"}],"responses":{"200":{"description":"Successful response (free)","content":{"application/json":{"schema":{"type":"object"},"example":{"found":true,"company":{"razonSocial":"ESCANHER ABOGADOS SAS","nitFull":"900170781-7","estadoMatricula":"ACTIVA"}}}}},"400":{"description":"Invalid input (does not use quota)"},"402":{"description":"Free quota used up: x402 Payment Required for the paid route"},"503":{"description":"Upstream RUES unavailable (quota refunded)"}}}},"/mcp":{"post":{"operationId":"mcp","security":[],"summary":"Remote MCP server (Streamable HTTP, JSON-RPC): free-tier tools co_company_status and co_company_lookup","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC response"}}}},"/health":{"get":{"operationId":"health","security":[],"summary":"Free: /health","responses":{"200":{"description":"OK"}}}},"/llms.txt":{"get":{"operationId":"llmstxt","security":[],"summary":"Free: /llms.txt","responses":{"200":{"description":"OK"}}}},"/openapi.json":{"get":{"operationId":"openapijson","security":[],"summary":"Free: /openapi.json","responses":{"200":{"description":"OK"}}}},"/status/free-tier":{"get":{"operationId":"statusfreetier","security":[],"summary":"Free: /status/free-tier","responses":{"200":{"description":"OK"}}}},"/privacy":{"get":{"operationId":"privacy","security":[],"summary":"Free: /privacy","responses":{"200":{"description":"OK"}}}},"/.well-known/x402":{"get":{"operationId":"wellknownx402","security":[],"summary":"Free: /.well-known/x402","responses":{"200":{"description":"OK"}}}}}}