Introduction

The Insolvencies.live API offers real-time access to insolvency notices from multiple European countries, utilizing Pusher Channels technology. This documentation will guide you through the integration process using Pusher Channels to receive real-time updates.

Getting Started with Pusher Channels

To begin receiving real-time insolvency notices, you need to integrate the Pusher Channels client into your application.

Steps:

1. Create an Account: Register on Insolvencies.live by visiting our registration page.
2. Obtain Pusher Credentials: Upon registration, we will provide you with the required YOUR_PUSHER_KEY and channel names.
3. Integrate Pusher into Your Application: Utilize the Pusher SDK corresponding to your programming language to connect to the channels.

Subscribing to Channels

Insolvency notices are broadcast on specific channels designated by country codes. You can subscribe to the channels relevant to your interests.

Available Channels:

• insolvencies.FR - France
• insolvencies.DE - Germany
• Channel names for beta countries are subject to change; valid channel names will be provided upon request.

Client-Side Subscription Example:

In the following example, we use the Pusher JavaScript library. However, many other programming languages are supported.

    const pusher = new Pusher('YOUR_PUSHER_KEY', {
    cluster: 'eu'
    });

    const channel = pusher.subscribe('insolvencies.FR');

    channel.bind('new-notice', function(data) {
    console.log('Received new insolvency notice:', data);
    });
          

Error Handling

Remember to implement error handling as per the guidelines of the Pusher Channels client library you are using. Ensure that you have appropriate error listeners to capture any issues with subscriptions or events.

Error Listener Example:

    pusher.connection.bind('error', function(err) {
    console.error('Pusher error:', err);
    });
          

Example Data Structures

Below are standard formats for insolvency notices you'll receive when subscribing to our real-time feed. All notices follow a unified schema that accommodates country-specific variations while maintaining consistent core fields.

German Insolvency Notice Example

        {
          "id": "DE-2024-0711-502IN2018",
          "country": "DE",
          "publication_date": "2024-07-11T00:00:00Z",
          "court": {
            "name": "District Court Bremen",
            "reference": "502 IN 20/18"
          },
          "case_type": "Insolvency Proceedings",
          "entity": {
            "name": "BPY Verwaltungs 01 GmbH",
            "registration_number": "HRB 33938 HB",
            "legal_form": "Limited Liability Company",
            "address": {
              "street": "Herdentorswallstrasse 93",
              "postal_code": "28195",
              "city": "Bremen",
              "country": "DE"
            }
          },
          "administrators": [
            {
              "name": "Holger Dahm",
              "role": "Managing Director",
              "address": "Katharinenfleet 9, 20457 Hamburg"
            },
            {
              "name": "Attorney Berend Böhme",
              "role": "Insolvency Administrator"
            }
          ],
          "financials": {
            "asset_value": 20381.27,
            "currency": "EUR"
          }
        }
          

French Insolvency Notice Example

        {
          "id": "FR-2024-0814-529714636",
          "country": "FR",
          "publication_date": "2024-08-14T00:00:00Z",
          "court": {
            "name": "Commercial Court of Angoulême",
          },
          "case_type": "Closure Judgment Due to Insufficient Assets",
          "entity": {
            "name": "CODEANDSOFT",
            "registration_number": "529 714 636 RCS Angoulême",
            "legal_form": "Simplified Joint-Stock Company",
            "address": {
              "street": "6 rue Joliot-Curie",
              "postal_code": "16600",
              "city": "Magnac-sur-Touvre",
              "country": "FR"
            },
            "activity": "Retail sale of computers, peripheral units and software in specialized stores"
          },
          "decisions": [
            {
              "type": "Closure",
              "date": "2024-08-09",
              "details": "Judgment pronouncing the closure of liquidation proceedings due to insufficient assets"
            }
          ]
        }
          

Common Field Descriptions

Common Translations

The API provides English translations for common legal terms while preserving original identifiers:

Case Types

Legal Forms

Support

If you have any questions or need assistance, please contact us.