Frequently asked questions

Registralia turns the public company registers of Latin American tax authorities into a clean, machine-readable API. You send an official identifier — an Ecuadorian RUC or a Costa Rican cédula jurídica — and get back a structured JSON record with the legal name, taxpayer status, activity, obligations and the authority's own risk flags, exactly as the register holds them at the moment of the request. Today: Ecuador (SRI) and Costa Rica (Hacienda). The service is built and run by a one-person company in Görlitz, Germany.

Three steps, every time: (1) you hand over a list of identifiers; (2) Registralia queries the authority's public register live for each one, validates and normalises the answer into one fixed schema; (3) you receive the result as JSON (or CSV, Excel, XML). Nothing is served from a cache or a purchased database — every record is fetched fresh and carries source, sourceUrl and scrapedAt so you can reproduce it against the register yourself.

We do not publish the technical details of how the registers are read. What matters for your due diligence is that the source is the official register and that every record is verifiable through its sourceUrl.

Apify is a cloud platform for running data tools — it calls them Actors. An Actor is a small program hosted on Apify that you can start from a web console, from a schedule or through an API call; it runs on Apify's servers, stores its results in a dataset, and you download them in the format you like. Apify Store is the marketplace where developers publish their Actors and companies use them. Apify Technologies s.r.o. is based in Prague, Czech Republic, and is used by tens of thousands of companies worldwide.

Registralia's products are Actors on Apify Store: apify.com/registralia.

• No new vendor for you. You pay Apify, Apify invoices you (EU company, proper VAT invoices) and pays us. Your procurement team onboards one platform, not a one-person company in Germany.
• Pay per record, no contract. Apify's pay-per-event model lets us charge $0.014 per company record found, with no subscription or minimum. Your account has a free monthly credit, so the first few hundred lookups cost nothing.
• Infrastructure you don't have to trust us with. Hosting, scaling, API keys, scheduling, storage, retries and monitoring are Apify's — audited and battle-tested — not ours.
• Integrations out of the box. Apify connects to Make, Zapier, n8n, Google Sheets, Slack, webhooks and every programming language via its API and SDKs.

In short: we concentrate on getting the registry data right; Apify does everything around it better than we could.

1. Go to console.apify.com/sign-up. Sign up with an e-mail address or with a Google/GitHub account. No credit card is required for the free plan.
2. Confirm the verification e-mail.
3. You are in the Apify Console. The free plan gives you a monthly platform credit (currently $5) that is applied automatically to any paid Actor — enough for roughly 300 company lookups per month at Registralia's price.
4. Optional: under Settings → Billing you can add a payment method later, when your volume grows beyond the free credit.

That's it. There is no separate Registralia account — Apify is the only login you need.

1. Open the Actor page, e.g. Ecuador Company Lookup — SRI, and click Try for free (or Start if you are logged in).
2. In the input form, paste your identifiers — one per line or as a JSON array — and choose the options (for Ecuador: whether to include establishments).
3. Click Start. The run takes a few seconds per identifier.
4. When it finishes, open the Output or Storage tab. Download the dataset as JSON, CSV, Excel or XML, or preview it in a table right there.

Every run keeps its input and output in your account, so you have an audit trail of what you looked up and when.

Every Actor has a REST endpoint. The simplest synchronous call — send identifiers, get the records back in the same HTTP response:

curl -X POST "https://api.apify.com/v2/acts/registralia~ecuador-sri-ruc-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rucs": ["1790016919001", "0990004196001"]}'

For Costa Rica use registralia~costa-rica-cedula-scraper and the input field identifications. Append &format=csv or &format=xlsx to get other formats. For larger batches use the asynchronous /runs endpoint and fetch the dataset when the run has finished, or let Apify call a webhook on your side.

Your API token is under Settings → Integrations in the Apify Console. Official client libraries exist for JavaScript/TypeScript and Python (apify-client); the full API reference is at docs.apify.com/api/v2. The field-by-field output schema is in our data dictionary.

Yes. Three ways without any programming:

• Apify Console — paste identifiers into the form, download Excel. Nothing to install.
• Make / Zapier / n8n — Apify has official modules on all three. A typical flow: new row in Google Sheets → run Registralia Actor → write the result back to the sheet or into your CRM.
• Google Sheets — Apify's own Google Sheets integration pushes a finished dataset into a spreadsheet automatically.

And if you would rather not touch any tool at all: e-mail us a list of up to 50 identifiers and we send the results back as Excel within 24 hours, free.

• Saved Tasks. In the Console, save the Actor with your preferred input as a Task. One click (or one API call) re-runs it with the same settings.
• Schedules. Attach a schedule to a Task — e.g. re-check your whole supplier list every Monday at 06:00 — and let Apify run it unattended.
• Webhooks. Have Apify notify your system the moment a run finishes, with a link to the results.
• Monitoring. Apify can alert you when a run fails or the number of results deviates from what you expect.
• Spending limits. Set a monthly cap on your account so a bulk job can never surprise you.
• Team access. Apify organisations let several colleagues share one account, one bill and one set of results.

Because billing is per record, the cost scales exactly with what you check — no seat licences, no annual renewal.

$0.014 per company record found, plus $0.0005 per additional establishment if you ask for establishments (Ecuador), plus an Actor start fee of $0.0001 per run. Not-found and malformed identifiers are free. Screening 500 suppliers therefore costs about $7.00. There is no subscription, no minimum and no setup fee. Apify's free monthly credit covers roughly the first 300 lookups each month.

Ecuador — RUC (13 digits) of companies and natural persons, from the Servicio de Rentas Internas. Costa Rica — cédula jurídica, cédula física, DIMEX and NITE from the Ministerio de Hacienda. The LATAM Company Lookup Actor accepts a mixed list and routes each identifier to the right register automatically. Further countries are added when there is a concrete customer need — tell us which register you are missing.

As current as the authority's register at the second you ask. There is no Registralia database that could go stale — every request is a live query. The scrapedAt timestamp in each record tells you exactly when it was fetched, and Ecuador additionally carries the register's own registryUpdatedAt date.

You get a record with found: false and the reason, and you are not charged for it. A malformed identifier (wrong length, invalid province code, wrong check digit) is rejected before the register is queried at all, also free of charge.

The registers are public sources maintained by the authorities themselves; Registralia adds no data of its own and keeps no copy of the results — they live only in your Apify account. You are the controller for your lookups; Registralia acts as processor for the tool, Apify handles platform and billing. Both Registralia (Germany) and Apify (Czech Republic) are in the EU and subject to the GDPR. The live demo on this website deliberately accepts company identifiers only. Details in our privacy notice.

Write one line to [email protected] and tell us which country interests you. The code comes back the same or next business day, is valid for 30 days and gives you ten live lookups directly on the demo page — no account anywhere. If your code is used up and you want more, just ask.

E-mail [email protected]. You will get an answer from the person who built the service, usually within one business day. Platform questions (billing, account, API keys) are answered by Apify's support at help.apify.com.