USE CASE
Every company registered today, as a feed
Newly incorporated companies across every registry the API covers — filtered by incorporation date, paged with a cursor, from one REST API and one key.
As at 7 November 2026: yes. Filter the company search by founded_after and a country, page with the cursor, and hydrate the companies you care about. The register decides how fresh the feed is: it lags the real incorporation by days, and by up to a month for the United Kingdom.
| What you want | Call | Credits | Where |
|---|---|---|---|
| Companies incorporated since a date | GET /companies/search?country=ES&founded_after=2026-11-01 | 1 per page of up to 100 | Every live country whose register gives a founding date (none for Japan, Switzerland, Germany); the United Kingdom arrives with the monthly Companies House file |
| One company in full | GET /companies/{id} | 1 | Same countries |
| New registrations as events | GET /company-events/search?country=ES (country feed, newest first) | 2 | Gazette events for Spain, France, the United Kingdom; register-change events for the other monitored countries, dated when first seen in the register data. At most 31 days back |
Who this is for
- Selling to new businesses. Company formation is the trigger event — new entities need banking, accounting, insurance, software and legal setup.
- Market research. Formation rates by region and activity code are a live economic indicator.
- Competitor and shell-company watch. Catch new entities registered in your sector, or at an address you are already tracking.
- Seeding a CRM or data product with fresh, primary-source entities rather than a stale purchased list.
Two calls
Filter the search endpoint by incorporation date, then hydrate whichever records matter. founded_before is supported too, so you can pull a bounded historical window instead of an open-ended one.
# Every company registered in Spain since 1 July 2026
curl -s "https://api.prometiam.com/functions/v1/risk-api/companies/search\
?founded_after=2026-07-01&country=ES&limit=100" \
-H "Authorization: Bearer rk_live_your_api_key"
# Then hydrate the ones you care about
curl -s "https://api.prometiam.com/functions/v1/risk-api/companies/59884?country=ES" \
-H "Authorization: Bearer rk_live_your_api_key"A daily feed, in full
Follow the cursor until has_more is false. Up to 100 records per call.
import requests
BASE = "https://api.prometiam.com/functions/v1/risk-api"
HEADERS = {"Authorization": "Bearer rk_live_your_api_key"}
def new_companies(country: str, since: str):
"""Yield every company incorporated on/after `since`, following the cursor."""
cursor = None
while True:
params = {"founded_after": since, "country": country, "limit": 100}
if cursor:
params["cursor"] = cursor
r = requests.get(f"{BASE}/companies/search", params=params, headers=HEADERS)
r.raise_for_status()
body = r.json()
yield from body["data"]
page = body.get("pagination", {})
if not page.get("has_more"):
break
cursor = page.get("next_cursor")
for company in new_companies("ES", "2026-07-01"):
print(company["company_name"], company.get("founding_date"), company.get("city"))

Coverage and honest limits
- Incorporation dates are available in every live country except Japan, Switzerland and Germany, whose registers publish none, with the same filters and the same response schema in each country.
- UK companies arrive with Companies House's monthly file, up to a month after incorporation. Norwegian bankruptcy estates (legal form
KBO) are units of the register, not companies: they carry no founding date, so the feed never lists them. - Directors and officers are available for Spain, France, the UK, Norway, Poland and the Czech Republic (Polish natural persons are masked by the register itself; Czech natural persons are the name and the month and year of birth only). Every other country is company records only — no director data.
- Registry publication lags real-world incorporation by days, and that lag differs per country. This is a registry feed, not a real-time firehose.
- Contact details are sparse on brand-new companies — a company registered last week rarely has a website or a listed phone number yet.
What it costs
The free trial is 500 credits over 14 days with a card required and nothing charged for 14 days — enough to prototype a feed. Starter (€9.99/month, 1,000 credits) covers a small feed with hydration (1 credit per record); Professional (€29.99/month, 10,000 credits) a modest national one and Scale (€99.99/month, 50,000 credits) a large one. Rate limits run from 10 to 300 requests per minute by plan. See pricing.