CHdata

API dati

API per i dati delle imprese svizzere

Tutti i dati del Suo piano per i Suoi sistemi, in JSON: un'impresa per IDI o liste per cantone, località, settore e forma giuridica. Inclusa in ogni piano da Start, con lo stesso volume mensile dell'export.

Scegliere un pianoChiave nell'account

Chiave

Da creare nell'account (al massimo 3 per account) e da inviare con ogni richiesta. Salviamo solo un hash della chiave.

Authorization: Bearer chd_live_…

Endpoint

  • GET /api/v1/firma/{uid}

    Un'impresa con tutti i livelli del Suo piano. Conta 1 impresa; un IDI sconosciuto non conta.

  • GET /api/v1/suche?kanton=ZH&branche=treuhand&seite=1

    Imprese per filtri: q (nome o IDI), kanton (TI), ort (lugano), rechtsform (aktiengesellschaft), branche (treuhand), status (aktiv o alle); seite, pro_seite (fino a 100). Conta le imprese fornite.

  • GET /api/v1/nutzung

    Piano e volume di questo mese. Non conta nulla.

Volume e limiti

Si contano le imprese, non le richieste: una pagina con 100 imprese conta 100. Ogni risposta indica lo stato nelle intestazioni X-Volume-Limit, X-Volume-Used e X-Volume-Left. Al massimo 600 richieste al minuto per chiave.

Errori

401 chiave mancante o revocata · 402 nessun piano attivo · 404 IDI non nel registro · 429 volume esaurito o più di 600 richieste al minuto.

Esempio

curl -H "Authorization: Bearer $CHDATA_KEY" \
  https://chdata.ch/api/v1/firma/CHE-203.381.047
{
  "plan": "profi",
  "layers": [
    "basis",
    "personen",
    "verlauf"
  ],
  "company": {
    "uid": "CHE-203.381.047",
    "name": "PatMi AG",
    "legal_form": "aktiengesellschaft",
    "legal_form_name": "Aktiengesellschaft",
    "status": "active",
    "address": {
      "care_of": "c/o Michael Hirt",
      "street": "Seestrasse 248b",
      "zip": "8713",
      "city": "Uerikon",
      "canton": "ZH"
    },
    "industries": [],
    "purpose": null,
    "capital": null,
    "registered": "2026-10-23",
    "lei": null,
    "licences": [],
    "people": {
      "president": [
        "Michael Christian Hirt"
      ],
      "management": [],
      "board": [
        "Patricia Silvia Hirt"
      ],
      "sole_signature": [
        "Michael Christian Hirt",
        "Patricia Silvia Hirt"
      ],
      "count": 2,
      "auditors": []
    },
    "history": {
      "last_notice": "2026-10-23",
      "notices": 1,
      "last_events": [
        "new"
      ],
      "renames": 0,
      "seat_moves": 0,
      "people_changes": 0,
      "public_awards": {
        "count": 0,
        "sum_chf": null
      }
    }
  },
  "source": "CHdata.ch"
}

Campi per piano

Ogni impresa contiene i campi dei livelli del Suo piano; un campo vuoto significa: nulla nel registro.

Dati di baseStart

  • uid
  • name
  • legal_form
  • legal_form_name
  • status
  • address
  • industries
  • purpose
  • capital
  • registered
  • lei
  • licences

Persone & firmada Start

  • people.president
  • people.management
  • people.board
  • people.sole_signature
  • people.count
  • people.auditors

Storicoda Pro

  • history.last_notice
  • history.notices
  • history.last_events
  • history.renames
  • history.seat_moves
  • history.people_changes
  • history.public_awards

Segnalida Expert

  • signals.status_event
  • signals.revoked
  • signals.auditor_left
  • signals.departures
  • signals.care_of
  • signals.same_address
  • signals.proceedings
  • signals.enforcements
API per i dati delle imprese svizzere | CHdata