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 wantCallCreditsWhere
Companies incorporated since a dateGET /companies/search?country=ES&founded_after=2026-11-011 per page of up to 100Every 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 fullGET /companies/{id}1Same countries
New registrations as eventsGET /company-events/search?country=ES (country feed, newest first)2Gazette 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"))
Customer dashboard screenshot: companies founded in a date rangeCustomer dashboard screenshot: companies founded in a date range
New companies in the dashboard: leave the name empty, set the founding dates and the search lists what was founded in the range. Shown for Latvia. Open it in the dashboard

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.

Sign up Read the docs