GET /v0/companies/:id
Get the company data (includes Commerce Register data)

Examples

{
  "data": {
    "id": "607334",
    "type": "companies",
    "attributes": {
      "commerce_register_data": {
        "uid": "CHE462714168",
        "chid": "CH55011150886",
        "name": "Finalta Sàrl",
        "canton": "VD",
        "ehraid": 1118251,
        "status": "ACTIVE",
        "address": {
          "city": "Morges",
          "addon": "",
          "po_box": "",
          "street": "Place de la Gare",
          "care_of": "",
          "house_number": "2",
          "organisation": "Finalta Sàrl",
          "swiss_zip_code": "1110"
        },
        "purpose": "La société a pour but: le conseil en organisation et développement de sociétés, en particulier dans le domaine de la gestion financière et de la stratégie (pour but complet cf. statuts).",
        "old_names": null,
        "sogc_date": "2018-10-09",
        "legal_form": {
          "id": 4,
          "uid": "0107",
          "name": {
            "de": "Gesellschaft mit beschränkter Haftung",
            "en": "Limited Liability Company",
            "fr": "Société à responsabilité limitée",
            "it": "Società a garanzia limitata"
          },
          "short_name": {
            "de": "GmbH",
            "en": "LLC",
            "fr": "Sàrl",
            "it": "Sagl"
          }
        },
        "legal_seat": "Morges",
        "translation": null,
        "head_offices": null,
        "deletion_date": null,
        "legal_seat_id": 5642,
        "branch_offices": [
          {
            "uid": "CHE182321818",
            "chid": "CH64541127664",
            "name": "Finalta Sàrl, succursale du Locle",
            "ehraid": 1217830,
            "status": "ACTIVE",
            "sogc_date": "2018-11-13",
            "legal_form": {
              "id": 9,
              "uid": "0151",
              "name": {
                "de": "Zweigniederlassung",
                "en": "Branch",
                "fr": "Succursale",
                "it": "Succursale"
              },
              "short_name": {
                "de": "ZN",
                "en": "Bran",
                "fr": "Succ",
                "it": "Succ"
              }
            },
            "legal_seat": "Le Locle",
            "deletion_date": null,
            "legal_seat_id": 6436,
            "registry_of_commerce_id": 645
          },
          {
            "uid": "CHE200158091",
            "chid": "CH62690185110",
            "name": "Finalta Sàrl, Succursale de St-Luc, Commune d'Anniviers",
            "ehraid": 1336865,
            "status": "ACTIVE",
            "sogc_date": "2018-02-06",
            "legal_form": {
              "id": 9,
              "uid": "0151",
              "name": {
                "de": "Zweigniederlassung",
                "en": "Branch",
                "fr": "Succursale",
                "it": "Succursale"
              },
              "short_name": {
                "de": "ZN",
                "en": "Bran",
                "fr": "Succ",
                "it": "Succ"
              }
            },
            "legal_seat": "Anniviers",
            "deletion_date": null,
            "legal_seat_id": 6252,
            "registry_of_commerce_id": 626
          }
        ],
        "has_taken_over": null,
        "audit_companies": null,
        "capital_nominal": "20000",
        "capital_currency": "CHF",
        "was_taken_over_by": null,
        "further_head_offices": null,
        "registry_of_commerce_id": 550,
      },
      "company_size": "micro",
      "established_at": "2012-11-01",
      "language": "fr",
      "latitude": 46.5111213,
      "linkedin_url": "https://www.linkedin.com/company/finalta-s-rl/",
      "longitude": 6.494185,
      "phone_numbers_list": "+41 12 345 67 89, +41 11 222 33 44",
      "purpose_de": "Das Unternehmen zielt darauf ab: Organisationsberatung und Entwicklungsunternehmen, insbesondere im Bereich der Finanzverwaltung und Strategie (für volle Ziel vgl Satzung).",
      "purpose_en": null,
      "purpose_fr": "La société a pour but: le conseil en organisation et développement de sociétés, en particulier dans le domaine de la gestion financière et de la stratégie (pour but complet cf. statuts)."
    },
    "relationships": {
      "noga_classification": {
        "data": {
          "id": "1412",
          "type": "noga_classifications"
        }
      },
      "website": {
        "data": {
          "id": "1003565",
          "type": "websites"
        }
      },
      "related_companies": {
        "data": [
          {
            "id": 677560,
            "type": "companies",
            "meta": { "labels": ["same_address"] } # Possible values for labels are: same_vat_group, same_address, same_website, shared_decision_makers.
          },
          {
            "id": 711313,
            "type": "companies",
            "meta": { "labels": ["same_address"] }
          }
        ]
      }
    },
    "links": {
      "self": "https://business-monitor.ch/en/companies/607334-finalta-sarl"
    }
  },
  "included": [
    {
      "attributes": {
        "code": "702200",
        "description_de": "Unternehmensberatung",
        "description_en": "Business and other management consultancy activities",
        "description_fr": "Conseil pour les affaires et autres conseils de gestion"
      },
      "id": "1412",
      "type": "noga_classifications"
    },
    {
      "id": "1003565",
      "type": "websites",
      "attributes": {
        "url": "finalta.ch"
      }
    }
  ]
}

Params

Param name Description
id
required

The company's UID number (prefixed with “CHE”, e.g. “CHE462714168”) or Business Monitor ID number (digits only).

Validations:

  • Must match regular expression /\A(CHE)?\d+\Z/.


GET /v0/companies/:id/commerce_register_data DEPRECATED
Get the Commerce Register data for a specific company

Examples

{
  "data": {
    "id": "607334",
    "type": "companies",
    "attributes": {
      "commerce_register_data": {
        "uid": "CHE462714168",
        "chid": "CH55011150886",
        "name": "Finalta Sàrl",
        "canton": "VD",
        "ehraid": 1118251,
        "status": "ACTIVE",
        "address": {
          "city": "Morges",
          "addon": "",
          "po_box": "",
          "street": "Place de la Gare",
          "care_of": "",
          "house_number": "2",
          "organisation": "Finalta Sàrl",
          "swiss_zip_code": "1110"
        },
        "purpose": "La société a pour but: le conseil en organisation et développement de sociétés, en particulier dans le domaine de la gestion financière et de la stratégie (pour but complet cf. statuts).",
        "old_names": null,
        "sogc_date": "2018-10-09",
        "legal_form": {
          "id": 4,
          "uid": "0107",
          "name": {
            "de": "Gesellschaft mit beschränkter Haftung",
            "en": "Limited Liability Company",
            "fr": "Société à responsabilité limitée",
            "it": "Società a garanzia limitata"
          },
          "short_name": {
            "de": "GmbH",
            "en": "LLC",
            "fr": "Sàrl",
            "it": "Sagl"
          }
        },
        "legal_seat": "Morges",
        "translation": null,
        "head_offices": null,
        "deletion_date": null,
        "legal_seat_id": 5642,
        "branch_offices": [
          {
            "uid": "CHE182321818",
            "chid": "CH64541127664",
            "name": "Finalta Sàrl, succursale du Locle",
            "ehraid": 1217830,
            "status": "ACTIVE",
            "sogc_date": "2018-11-13",
            "legal_form": {
              "id": 9,
              "uid": "0151",
              "name": {
                "de": "Zweigniederlassung",
                "en": "Branch",
                "fr": "Succursale",
                "it": "Succursale"
              },
              "short_name": {
                "de": "ZN",
                "en": "Bran",
                "fr": "Succ",
                "it": "Succ"
              }
            },
            "legal_seat": "Le Locle",
            "deletion_date": null,
            "legal_seat_id": 6436,
            "registry_of_commerce_id": 645
          },
          {
            "uid": "CHE200158091",
            "chid": "CH62690185110",
            "name": "Finalta Sàrl, Succursale de St-Luc, Commune d'Anniviers",
            "ehraid": 1336865,
            "status": "ACTIVE",
            "sogc_date": "2018-02-06",
            "legal_form": {
              "id": 9,
              "uid": "0151",
              "name": {
                "de": "Zweigniederlassung",
                "en": "Branch",
                "fr": "Succursale",
                "it": "Succursale"
              },
              "short_name": {
                "de": "ZN",
                "en": "Bran",
                "fr": "Succ",
                "it": "Succ"
              }
            },
            "legal_seat": "Anniviers",
            "deletion_date": null,
            "legal_seat_id": 6252,
            "registry_of_commerce_id": 626
          }
        ],
        "has_taken_over": null,
        "audit_companies": null,
        "capital_nominal": "20000",
        "capital_currency": "CHF",
        "was_taken_over_by": null,
        "further_head_offices": null,
        "registry_of_commerce_id": 550,
        "established_at": "2012-11-01",
        "noga_code": "702200"
      }
    },
    "links": {
      "self": "https://business-monitor.ch/en/companies/607334-finalta-sarl"
    }
  }
}

Params

Param name Description
id
required

The company's UID number (prefixed with “CHE”, e.g. “CHE462714168”) or Business Monitor ID number (digits only).

Validations:

  • Must match regular expression /\A(CHE)?\d+\Z/.


GET /v0/companies/changed_on/:date
Get companies for which there was a commerce register data change on a specific date (up to 7 days ago). Only includes companies previously fetched using other endpoints.

Examples

{
  "data": [
    {
      "attributes": {
        "uid": "390297146"
      },
      "id": "986657",
      "type": "companies"
    },
    {
      "attributes": {
        "uid": "107424117"
      },
      "id": "986670",
      "type": "companies"
    }
  ]
}

Params

Param name Description
date
required

A date in the format “YYYY-mm-dd”, e.g. “2019-02-23”.

Validations:

  • Must match regular expression /\A\d{4}-\d{2}-\d{2}\Z/.


GET /v0/companies/search_by_name
Search companies by name. Supports fuzziness. Responds with a maximum of 30 results.

Examples

# curl -H "Authorization: Bearer your_api_key" 'https://api.business-monitor.ch/v0/companies/search_by_name?filters[query]=Novretur'
{
  "data": [
    {
      "id": "522490",
      "type": "companies",
      "attributes": {
        "name": "Novertur International SA",
        "zip_code": "1003",
        "city": "Lausanne",
        "uid":283912112
      }
    }
  ]
}

Params

Param name Description
filters
required

Validations:

  • Must be a Hash

filters[query]
required

Search query.

Validations:

  • Must be a String