REST API

REGMO Data API

Read-only Zugriff auf Handelsregister-Firmendaten (companies) und öffentliche Geschäftsprofile mit Kontaktdaten (locals). Alle Endpoints sind reine GET-Abfragen — es gibt keine Schreiboperationen.

Authentifizierung

Jeder Request benötigt einen gültigen API-Key im X-API-Key Header.

Sie besitzen noch keinen aktiven API-Schlüssel oder sind nicht angemeldet.

Den API-Key erhältst du nach dem Login auf regmo.ch in deinem Benutzerprofil unter Einstellungen.

curl -X GET "https://api.regmo.ch/v1/" -H "X-API-Key: YOUR_API_KEY"

Antworten & Fehler

Alle Antworten sind JSON. Listen-Endpoints liefern total und results, Einzel-Ressourcen liefern success und data.

Erfolgreiche Anfragen liefern den Statuscode 200 OK zurück.
Bei ungültigen Parametern wird Statuscode 400 Bad Request mit { "success": false, "error": "..." } ausgegeben.
Ein fehlerhafter oder fehlender API-Schlüssel antwortet mit Statuscode 401 Unauthorized.
Ist das monatliche Anfragelimit erreicht, antwortet die API mit Statuscode 429 Too Many Requests.

Companies

Handelsregister-Firmendaten.

GET /v1/companies/search

Firmensuche nach Name, Stadt, Kanton, Status oder Rechtsform.

Parameter	Typ	Beschreibung
`q`	string	Firmenname
`city`	string	Stadt
`canton`	string	Kanton-Kürzel, `ZH`
`status`	string	`ACTIVE`, `CANCELLED`, `BEING_CANCELLED`
`legal_form`	string	Rechtsform, z. B. `AG`,`GmbH`...
`limit`	number	Max. 100, Standard 20
`offset`	number	Standard 0

curl -X GET "https://api.regmo.ch/v1/companies/search?q=Muster&city=Z%C3%BCrich&canton=ZH&limit=10" \
     -H "X-API-Key: YOUR_API_KEY"

{
    "total": 3,
    "results": [
        {
            "id": "3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21",
            "name": "Beispiel Muster AG",
            "uid": "CHE123456789",
            "status": "ACTIVE",
            "legal_form_short": "AG",
            "legal_form": "Aktiengesellschaft",
            "canton": "ZH",
            "street": "Musterstrasse",
            "house_number": "10",
            "city": "Zürich",
            "zip_code": "8004"
        },
        {
            "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789",
            "name": "Muster Handels-Genossenschaft",
            "uid": "CHE987654321",
            "status": "ACTIVE",
            "legal_form_short": "Gen",
            "legal_form": "Genossenschaft",
            "canton": "ZH",
            "street": "Teststrasse",
            "house_number": "5",
            "city": "Zürich",
            "zip_code": "8050"
        },
        {
            "id": "9c8d7e6f-5a4b-3c2d-1e0f-a9b8c7d6e5f4",
            "name": "Beispiel Dienstleistungen, Erika Muster",
            "uid": "CHE111222333",
            "status": "ACTIVE",
            "legal_form_short": "EIU",
            "legal_form": "Einzelunternehmen",
            "canton": "ZH",
            "street": "Beispielweg",
            "house_number": "22",
            "city": "Zürich",
            "zip_code": "8003"
        }
    ]
}

GET /v1/companies/uid/:uid

Vollständiges Firmenprofil per UID (CHE-xxx.xxx.xxx) — der häufigste Lookup.

curl -X GET "https://api.regmo.ch/v1/companies/uid/CHE-123.456.789" \
     -H "X-API-Key: YOUR_API_KEY"

{
    "success": true,
    "data": {
        "id": "3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21",
        "ehraid": 1234567,
        "uid": "CHE123456789",
        "chid": "CH55055066077",
        "name": "Muster IT-Solutions KLG",
        "status": "ACTIVE",
        "legal_form": "Kollektivgesellschaft",
        "legal_form_short": "KlG",
        "legal_seat": "Musterhausen",
        "canton": "ZH",
        "purpose": "Internetdienstleistungen und Betrieb von Webserver-Infrastruktur sowie Datenverarbeitung und -sicherung.",
        "capital_nominal": null,
        "capital_currency": null,
        "sogc_date": "2024-07-16T22:00:00.000Z",
        "deletion_date": null,
        "street": "Musterstrasse",
        "house_number": "12",
        "city": "Musterhausen",
        "zip_code": "8400",
        "cantonal_excerpt_web": "https://zh.chregister.ch/cr-portal/auszug/auszug.xhtml?uid=CHE-123.456.789",
        "zefix_web": "https://www.zefix.admin.ch/de/search/entity/list?name=CHE123456789&directLink=true",
        "head_offices": [],
        "branch_offices": [],
        "has_taken_over": [],
        "was_taken_over_by": [],
        "audit_companies": [],
        "old_names": [],
        "created_at": "2026-04-05T09:47:49.831Z",
        "local_id": "3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21",
        "local": {
            "id": "3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21",
            "title": "Muster IT-Solutions KLG",
            "subtitle": "Mit REGMO erzielen Sie grossartige Ergebnisse!",
            "street": "Musterstrasse",
            "house_number": "4",
            "zip": "8400",
            "canton_code": "ZH",
            "country": "CH",
            "city": "Musterhausen",
            "city_slug": "musterhausen",
            "address": "Musterstrasse 4, 8400 Musterhausen",
            "slug": "muster-it-solutions-klg-aB12cD3",
            "description": {
                "text": "<p>Wir sind eine erfahrene IT-Firma, die sich auf die Entwicklung von Online-Dienstleistungen und B2B-Anwendungen spezialisiert hat.</p#x3E;",
                "title": "Unsere Dienstleistungen"
            },
            "contacts": [
                {
                    "type": "EmailContact",
                    "label": "",
                    "value": "[email protected]",
                    "displayValue": "[email protected]"
                },
                {
                    "type": "URLContact",
                    "label": "",
                    "value": "https://musterit.ch",
                    "displayValue": "www.musterit.ch"
                }
            ],
            "is_office": false,
            "office_type": null,
            "attributes": {
                "Wir haben Erfahrung": [
                    "Marketing",
                    "Offline Marketing",
                    "Verkaufsdienst"
                ],
                "Wir haben eine eigene Software": [
                    "Eigene Server & Datenbanken",
                    "Massgeschneiderte KI-Modelle",
                    "Fundierte Expertise"
                ]
            },
            "schedule": {
                "timeZone": "Europe/Zurich",
                "regular": {
                "1": [ { "open": "10:00", "close": "13:00" } ],
                "2": [],
                "3": [],
                "4": [ { "open": "09:00", "close": "16:00" } ],
                "5": [],
                "6": [],
                "7": []
                },
                "exceptions": {}
            },
            "opening": {
                "openNow": false,
                "closesSoon": false,
                "opensSoon": false,
                "nextOpen": "2026-07-30 09:00",
                "nextClose": null,
                "statusKey": "OPENS_AT",
                "statusTextShort": "Öffnet Donnerstag",
                "statusTextLong": "Geschlossen – öffnet Donnerstag um 09:00",
                "todayBlocks": [],
                "usedException": false
            },
            "filiales": [],
            "reviews": [
                {
                    "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789",
                    "text": "Tolles Team und viel Einsatz — der technische Support und Kundendienst dieser Firma ist von weitem sichtbar.",
                    "rate": 5,
                    "reply": [
                        {
                            "text": "Vielen herzlichen Dank für das tolle Feedback! Wir schätzen euren unermüdlichen Einsatz und die grossartige Arbeit sehr. Schön, euch im Team zu haben! 🚀",
                            "created_at": "2026-07-25T11:59:54.165Z"
                        }
                    ],
                    "created_at": "2026-07-24T09:35:16.311Z",
                    "first_name": "Max",
                    "last_name": "Muster"
                },
                {
                    "id": "9c8d7e6f-5a4b-3c2d-1e0f-a9b8c7d6e5f4",
                    "text": "Ich bin sehr zufrieden mit der Firma und den angebotenen Dienstleistungen. Die Zusammenarbeit war sehr effektiv und die Kosten waren angemessen.",
                    "rate": 5,
                    "reply": [
                        {
                            "text": "Vielen Dank für Ihr grossartiges Feedback! Es freut uns ausserordentlich zu hören, dass Sie mit unserer Firma und unseren Dienstleistungen so zufrieden sind. Unser Ziel ist es immer, eine möglichst effektive Zusammenarbeit auf Augenhöhe zu bieten und dabei ein faires Preis-Leistungs-Verhältnis zu wahren.",
                            "created_at": "2026-07-20T21:49:12.641Z"
                        }
                    ],
                    "created_at": "2026-07-10T17:36:31.622Z",
                    "first_name": "Erika",
                    "last_name": "Beispiel"
                }
            ],
            "profile_link": "https://regmo.ch/schweiz/zuerich/musterhausen/muster-it-solutions-klg-aB12cD3"
        }
    }
}

GET /v1/companies/:id

Identisch zu /companies/uid/:uid, aber per interner ID.

curl -X GET "https://api.regmo.ch/v1/companies/3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21" \
     -H "X-API-Key: YOUR_API_KEY"

{
    "success": true,
    "data": {
        "id": "3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21",
        "ehraid": 1234567,
        "uid": "CHE123456789",
        "chid": "CH55055066077",
        "name": "Muster IT-Solutions KLG",
        "status": "ACTIVE",
        "legal_form": "Kollektivgesellschaft",
        "legal_form_short": "KlG",
        "legal_seat": "Musterhausen",
        "canton": "ZH",
        "purpose": "Internetdienstleistungen und Betrieb von Webserver-Infrastruktur sowie Datenverarbeitung und -sicherung.",
        "capital_nominal": null,
        "capital_currency": null,
        "sogc_date": "2024-07-16T22:00:00.000Z",
        "deletion_date": null,
        "street": "Musterstrasse",
        "house_number": "12",
        "city": "Musterhausen",
        "zip_code": "8400",
        "cantonal_excerpt_web": "https://zh.chregister.ch/cr-portal/auszug/auszug.xhtml?uid=CHE-123.456.789",
        "zefix_web": "https://www.zefix.admin.ch/de/search/entity/list?name=CHE123456789&directLink=true",
        "head_offices": [],
        "branch_offices": [],
        "has_taken_over": [],
        "was_taken_over_by": [],
        "audit_companies": [],
        "old_names": [],
        "created_at": "2026-04-05T09:47:49.831Z",
        "local_id": null,
        "local": null
    }
}

Locals

Öffentliche Geschäftsprofile mit Kontaktdaten (nur aktive Einträge).

GET /v1/locals/search

Suche nach Name, Adresse, Stadt, PLZ, Kanton oder Kategorie.

Parameter	Typ	Beschreibung
`q`	string	Name/Strasse
`city`	string	Stadt
`zip_code`	string	PLZ
`canton_code`	string	Kanton-Kürzel, `ZH`
`category`	string	Kategorie, z. B. `Coiffeur`, `Apotheke`
`limit`	number	Max. 100, Standard 20
`offset`	number	Standard 0

curl -X GET "https://api.regmo.ch/v1/locals/search?q=Coiffeur&city=Z%C3%BCrich&category=coiffeur" \
     -H "X-API-Key: YOUR_API_KEY"

{
    "total": 47,
    "results": [
        {
            "id": "3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21",
            "title": "Muster Coiffeur AG",
            "city": "Zürich",
            "zip": "8001",
            "street": "Bahnhofstrasse",
            "house_number": "1",
            "canton_code": "ZH",
            "country": "CH"
        },
        {
            "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789",
            "title": "Coiffeur Beispiel",
            "city": "Zürich",
            "zip": "8004",
            "street": "Musterstrasse",
            "house_number": "22",
            "canton_code": "TG",
            "country": "CH"
        }
    ]
}

GET /v1/locals/:id

Vollständiges öffentliches Profil inkl. Alle Daten.

curl -X GET "https://api.regmo.ch/v1/locals/3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21" \
     -H "X-API-Key: YOUR_API_KEY"

{
    "success": true,
    "data": {
        "id": "3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21",
        "title": "Muster Bäckerei AG",
        "subtitle": "Bäckerei, Konditorei, Bistro",
        "street": "Hauptstrasse",
        "house_number": "10",
        "zip": "4900",
        "city": "Langenthal",
        "city_slug": "langenthal",
        "address": "Hauptstrasse 10, 4900 Langenthal",
        "canton_code": "BE",
        "country": "CH",
        "slug": "muster-baeckerei-ag-aB12cD34",
        "description": {
        "text": "<p>Die Muster Bäckerei AG wurde 1987 gegründet und wird heute in dritter Generation geführt.</p>",
        "title": "Tradition und Handwerk",
        "additionalText": null
        },
        "contacts": [
        {
            "type": "EmailContact",
            "label": "",
            "value": "[email protected]",
            "displayValue": "[email protected]"
        },
        {
            "type": "URLContact",
            "label": "",
            "value": "https://www.musterbaeckerei.ch",
            "displayValue": "www.musterbaeckerei.ch"
        },
        {
            "type": "PhoneContact",
            "label": "",
            "value": "+41629261055",
            "displayValue": "062 926 10 55"
        }
        ],
        "is_office": false,
        "office_type": null,
        "attributes": null,
        "schedule": {
        "timeZone": "Europe/Zurich",
        "regular": {
            "1": [ { "open": "06:00", "close": "18:30" } ],
            "2": [ { "open": "06:00", "close": "13:30" }, { "open": "14:00", "close": "18:30" } ],
            "3": [ { "open": "06:00", "close": "13:30" }, { "open": "14:00", "close": "18:30" } ],
            "4": [ { "open": "06:00", "close": "13:30" }, { "open": "14:00", "close": "18:30" } ],
            "5": [ { "open": "06:00", "close": "18:30" } ],
            "6": [ { "open": "06:00", "close": "16:00" } ],
            "7": [ { "open": "07:00", "close": "12:00" } ]
        },
        "exceptions": {}
        },
        "opening": {
        "openNow": true,
        "closesSoon": false,
        "opensSoon": false,
        "nextOpen": null,
        "nextClose": "2026-07-28 18:30",
        "statusKey": "OPEN",
        "statusTextShort": "Geöffnet",
        "statusTextLong": "Geöffnet – schliesst um 18:30",
        "todayBlocks": ["06:00–18:30"],
        "usedException": false
        },
        "filiales": [
        {
            "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789",
            "contacts": [
            {
                "type": "EmailContact",
                "label": "",
                "value": "[email protected]",
                "displayValue": "[email protected]"
            },
            {
                "type": "URLContact",
                "label": "",
                "value": "https://www.musterbaeckerei.ch",
                "displayValue": "www.musterbaeckerei.ch"
            }
            ],
            "title": "Muster Bäckerei AG",
            "slug": "muster-baeckerei-ag-aB12cD34",
            "address": "Bahnhofstrasse 3, 4562 Biberist",
            "street": "Bahnhofstrasse",
            "house_number": "3",
            "city": "Biberist",
            "zip": "4562",
            "canton_code": "SO",
            "country": "CH",
            "city_slug": "biberist",
            "profile_url": "https://regmo.ch/schweiz/solothurn/biberist/muster-baeckerei-ag-aB12cD34"
        },
        {
            "id": "9c8d7e6f-5a4b-3c2d-1e0f-a9b8c7d6e5f4",
            "contacts": [],
            "title": "Muster Bäckerei AG",
            "slug": "muster-baeckerei-ag-standort2",
            "address": "Dorfstrasse 8, 4922 Bützberg",
            "street": "Dorfstrasse",
            "house_number": "8",
            "city": "Bützberg",
            "zip": "4922",
            "canton_code": "BE",
            "country": "CH",
            "city_slug": "buetzberg",
            "profile_url": "https://regmo.ch/schweiz/bern/buetzberg/muster-baeckerei-ag-standort2"
        }
        ],
        "reviews": [
        {
            "id": "2afaf2c1-7bce-4bcd-ac16-d5d2c452a614",
            "text": "Sehr zufrieden mit der Qualität der Backwaren. Die Auswahl ist gross, die Produkte schmecken immer frisch. Das Personal im Laden ist freundlich und hilfsbereit.",
            "rate": 4,
            "reply": null,
            "created_at": "2026-04-01T15:32:34.180Z",
            "first_name": "Max",
            "last_name": "Muster"
        },
        {
            "id": "47396b55-59b9-4ef8-9c3f-454e541b6cf2",
            "text": "Seit Jahren treuer Kunde und kann nur Positives berichten. Die Qualität ist konstant hoch und der Service freundlich.",
            "rate": 4,
            "reply": [
                {
                    "text": "Vielen Dank für Ihr grossartiges Feedback! Es freut uns ausserordentlich zu hören, dass Sie mit unserer Firma und unseren Dienstleistungen so zufrieden sind. Unser Ziel ist es immer, eine möglichst effektive Zusammenarbeit auf Augenhöhe zu bieten und dabei ein faires Preis-Leistungs-Verhältnis zu wahren.",
                    "created_at": "2026-07-20T21:49:12.641Z"
                }
            ],
            "created_at": "2026-02-22T23:45:53.532Z",
            "first_name": "Erika",
            "last_name": "Beispiel"
        }
        ],
        "zefix": [
            {
                "id": "41be4e1a-c881-49c8-873c-ec214b87194e",
                "uid": "CHE000000000",
                "chid": "CH00000000000",
                "name": "Muster Bäckerei AG",
                "status": "ACTIVE",
                "legal_form": "Aktiengesellschaft",
                "legal_form_short": "AG",
                "legal_seat": "Langenthal",
                "canton": "BE",
                "purpose": "Herstellung und Handel mit Backwaren, Führung von Bäckereien und Konditoreien sowie Betrieb von Tea-Rooms und Restaurants.",
                "capital_nominal": "500000",
                "capital_currency": "CHF",
                "street": "Hauptstrasse",
                "house_number": "10",
                "city": "Langenthal",
                "zip_code": "4900",
                "sogc_date": "2021-10-03T22:00:00.000Z",
                "deletion_date": null,
                "cantonal_excerpt_web": "https://be.chregister.ch/cr-portal/auszug/auszug.xhtml?uid=CHE-000.000.000",
                "zefix_web": "https://www.zefix.admin.ch/de/search/entity/list?name=CHE000000000&directLink=true",
                "branch_offices": [],
                "old_names": [],
                "sogc_publications": [
                {
                    "canton": "BE",
                    "sogcId": 1000000000,
                    "message": "Muster Bäckerei AG, in Langenthal, CHE-000.000.000, Aktiengesellschaft. Fusion: Übernahme der Aktiven und Passiven einer weiteren Gesellschaft gemäss Fusionsvertrag.",
                    "sogcDate": "2021-10-04",
                    "journalId": 15779,
                    "journalDate": "2021-09-29",
                    "mutationTypes": ["fusion"]
                },
                {
                    "canton": "BE",
                    "sogcId": 1000000001,
                    "message": "Muster Bäckerei AG, in Langenthal, CHE-000.000.000, Aktiengesellschaft. Änderung der Organe und Revisionsstelle.",
                    "sogcDate": "2020-08-20",
                    "journalId": 12330,
                    "journalDate": "2020-08-17",
                    "mutationTypes": ["aenderungorgane"]
                }
                ],
                "persons": [
                {
                    "id": "21c07324-4e3f-426d-98c9-784b838fdb41",
                    "name": "Peter Muster",
                    "rolle": "Inhaber",
                    "gender": "MALE",
                    "wohnort": "Winterthur",
                    "heimatort": "Zürich",
                    "seit_wann": "2013-02-14",
                    "heimatland": "Schweiz",
                    "unterschrift": "Einzelunterschrift"
                }
                ]
            }
        ],
        "profile_link": "https://regmo.ch/schweiz/bern/langenthal/muster-baeckerei-ag-aB12cD34"
    }
}

GET /v1/locals/:id/contacts

Nur die Kontakte, optional gefiltert per type (email, phone, mobile, fax, url, social_media).

curl -X GET "https://api.regmo.ch/v1/locals/3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21/contacts?type=email,phone" \
     -H "X-API-Key: YOUR_API_KEY"

{
    "success": true,
    "data": [
        {
            "type": "phone",
            "label": "",
            "value": "+41441234567",
            "displayValue": "044 123 45 67"
        },
        {
            "type": "email",
            "label": "",
            "value": "[email protected]",
            "displayValue": "[email protected]"
        }
    ]
}

GET /v1/locals/lookup/contact

Reverse-Lookup: welchem Local gehört diese E-Mail/Telefonnummer/URL/Social-Link.

Parameter	Beschreibung
`email`	E-Mail
`phone`	Telefonnummer
`url`	Website/Domain
`social`	Social-Media-Link

Kontakte mit aktivierter Werbe-Ablehnung werden grundsätzlich nie ausgegeben.

curl -X GET "https://api.regmo.ch/v1/locals/lookup/[email protected]" \
     -H "X-API-Key: YOUR_API_KEY"

{
    "total": 1,
    "results": [
        {
            "id": "3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21",
            "title": "Muster IT-Solutions KLG",
            "street": "Musterstrasse",
            "house_number": "12",
            "zip": "8400",
            "canton_code": "ZH",
            "country": "CH",
            "city": "Musterhausen"
        }
    ]
}

GET /v1/locals/:id/categories

Branchen-Kategorien des Locals.

curl -X GET "https://api.regmo.ch/v1/locals/3f2a9c10-1b2c-4d3e-9f8a-7e6d5c4b3a21/categories" \
     -H "X-API-Key: YOUR_API_KEY"

{
    "success": true,
    "data": [
        {
            "name": "Restaurant",
            "slug": "restaurant"
        },
        {
            "name": "Pizzeria",
            "slug": "pizzeria"
        },
        {
            "name": "Italienische Küche",
            "slug": "italienische-kueche"
        }
    ]
}