# Colombia Company Search by Name (RUES Registry)

> Colombia Company Search by Name (RUES Registry) is a paid API for AI agents from api.ssh.autos, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-14).

Searches Colombia's national RUES business registry for companies by name prefix, returning matching active registrations.

## Facts

- Endpoint: POST https://api.ssh.autos/v1/co/companies/search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/colombia-company-search-by-name-rues-registry-c9f9e639
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RWR-cAWYyYlMQo4ExmwAN

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 colombia-company-search-by-name-rues-registry-c9f9e639 -d '<json body>'
```

Example prompt: Can you search Colombia's RUES national business registry for companies named 'GRUPO NUTRESA' and return up to 10 results?

## When to prefer this

Use this endpoint when you need to look up Colombian companies by name in the official national RUES registry — particularly for due diligence, vendor verification, legal entity confirmation, or competitive research involving Colombian businesses. Prefer this over generic web search when you need structured, authoritative registration data rather than unstructured web results.

## Known failure modes

- Empty records array with status 'succeeded_empty' when no companies match the name prefix
- Input too short (companyName under 3 characters) causes validation error
- companyName exceeding 120 characters rejected
- maxResults outside 1–30 range rejected
- Network or registry availability issues may return error responses
- Misspelled or partial names may return zero results despite company existing

## How this service works

Live web and public-record data: marketplaces, real estate, social media, job listings, company registries and government tenders. Pay per call in USDC over x402 with no account, subscribe on the Apify Store, or buy a finished, sourced report.

## Output

Returns a JSON object with a 'records' array containing matching company registrations from Colombia's RUES registry (active matrículas listed first), plus a 'summary' object indicating the status (e.g. succeeded_empty) and total record count. Each record includes company identity and registration details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxResults": {
   "type": "integer",
   "title": "Maxresults",
   "default": 10,
   "maximum": 30,
   "minimum": 1
  },
  "companyName": {
   "type": "string",
   "title": "Companyname",
   "examples": [
    "GRUPO NUTRESA"
   ],
   "maxLength": 120,
   "minLength": 3,
   "description": "Razón social prefix, e.g. 'GRUPO NUTRESA'; active matrículas first."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "records": [],
  "summary": {
   "status": "succeeded_empty",
   "records": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/colombia-company-search-by-name-rues-registry-c9f9e639/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ssh.autos](https://www.zero.xyz/host/api.ssh.autos/llms.txt)
