Ecuador Company Registry API and MCP — Expediente and RUC Lookup
Send an expediente number or an RUC and you get the entry for that company from the Superintendencia de Compañías: expediente number, RUC and registered name.
- You send
- an expediente number or an RUC
- You get back
- Expediente number, RUC and registered name, with links to the open-data files
- Coverage
- Ecuador — entities on Superintendencia de Compañías.
- Price
- 5 pts — $5 per 1,000
- Charged only when the record resolves. A lookup that finds nothing is not billed.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Superintendencia de Compañías directly | Open Superintendencia de Compañías and read the record | Usually free, sometimes per-document | A different interface, language and data shape for every country you add |
| Collecting it yourself | Build and host a crawler per register, then keep each one alive | Infrastructure and maintenance | Registers change their pages without warning, and nobody is on the hook when yours breaks |
| NeuralVerge | One request, the same shape as every other source in the catalog | $5 per 1,000, misses not billed | Covers Ecuador — other countries are separate sources with the same request format |
What you get back
Every field in the example response below.
| Field | Type | Description |
|---|---|---|
session_id | string | Id of this run, for tracing. |
kind | string | Always "ec_companies". |
company | string | The identifier you sent. |
company_id | string | The identifier as the register keys it. |
human | string | Readable Markdown summary of the record. |
machine.company | object | The company record, described below. |
machine.blocked | boolean | False when the register answered normally. |
machine.pages_opened | number | Register pages read for this record. |
machine.proxy_traffic_bytes | number | Data transferred for the run. |
total_points | number | Points charged: 5 for a resolved lookup. |
machine.company.registration_number | string | Expediente number. |
machine.company.ruc | string | RUC, the Ecuadorian taxpayer number. |
machine.company.name | string | Registered company name. |
machine.company.status | null | Empty in the sample. |
machine.company.address | null | Empty in the sample. |
machine.company.url | string | Link to the register's company search page. |
machine.company.company_type | null | Empty in the sample. |
machine.company.incorporation_date | null | Empty in the sample. |
machine.company.open_data_files | array | Open-data files published by the register, each with name, description and url. |
Example response
A real response, as returned.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "ec_companies",
"company": "7154",
"company_id": "7154",
"human": "# Ecuador — Superintendencia de Compañías — company\n\n- **Number:** 7154\n- **Pages opened:** 1\n- **Proxy traffic:** 1.2 KB\n- **Name:** PROCESADORA NACIONAL DE ALIMENTOS C.A. PRONACA\n- **Source:** https://appscvsgen.supercias.gob.ec/consultaCompanias/societario/busquedaCompanias.jsf",
"machine": {
"company": {
"registration_number": "7154",
"ruc": "1790319857001",
"name": "PROCESADORA NACIONAL DE ALIMENTOS C.A. PRONACA",
"status": null,
"address": null,
"url": "https://appscvsgen.supercias.gob.ec/consultaCompanias/societario/busquedaCompanias.jsf",
"company_type": null,
"incorporation_date": null,
"open_data_files": [
{
"name": "bi_compania.csv",
"description": "Companies: expediente, RUC, name, type, province",
"url": "https://appscvsmovil.supercias.gob.ec/ranking/recursos/bi_compania.csv"
},
{
"name": "bi_ranking.csv",
"description": "Yearly financials and CIIU codes per company",
"url": "https://appscvsmovil.supercias.gob.ec/ranking/recursos/bi_ranking.csv"
}
]
},
"blocked": false,
"pages_opened": 1,
"proxy_traffic_bytes": 1199
},
"total_points": 5
}How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
One company per request. Pass the registration number or the link to the record on the register.
curl -X POST https://api.neuralverge.ai/functions/v1/run-ec-companies \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"7154"}'What teams use it for
Where this field shows up in an actual workflow.
Check that an RUC and expediente belong to the company on a document.
Convert between expediente number and RUC.
Use the file links to find the register's published company and ranking tables.
Confirm that a company exists in the register before deeper checks.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Ecuador — entities on Superintendencia de Compañías.
Read at request time, so the answer reflects the register as it stands when you ask.
Superintendencia de Compañías is a public register. Every response carries the source URL it was read from and a session id you can trace.
- —Only expediente, RUC and name come back. Status, address, type and incorporation date were null in the sample.
- —The open_data_files entries are links to files the register publishes; their contents are not part of this response.
- —No directors or financials in this record.
Questions, answered
The file number the Superintendencia de Compañías assigns to a company. The sample uses 7154.
Related sources
Try ecuador company on your own data
One request format across every source in the catalog.