Skip to content

View event history

The tebio Business Portal logs important events in the life cycle of a subscription. In the event history you will find detailed overviews of past and planned status changes, pauses, and system and user actions.

Use event history if you want to track changes or processes to a subscription. Typical questions are:

  • When was the subscription paused by the customer?
  • Who recorded the termination in the system?
  • Was the last automatic renewal successful?
  • You need access to the detailed view of an active, paused or canceled subscription.

You can access the detailed view of the contract in two different ways:

Way 1: Via the customer view

  1. Open the relevant user’s customer view.
  2. Select the contract you want from the dropdown.
  3. Click on “Show details” to switch to the detailed view of the subscription.

Way 2: Via Global Search

  1. Use the direct search in the top menu under “Subscriptions”.
  2. Search for the specific contract number and click on the result.

Once you are in the subscription detail view, the first tab “Events” is already open by default.

The view is divided into three different tables to present information in context:

1. Status changes All basic status changes of the main product and the booked options are listed here (e.g. change from active to paused or deactivated). You can see at a glance the date, the affected product, as well as the old and new status.

2. Breaks In this table, all past, active and future planned breaks are clearly logged with their start (“break from”) and end date (“break to”).

3. Events This is the subscription’s event log. Here, every system action (e.g. “subscription extension was successful”) and every user action is logged chronologically. The “User Account” column tells you which system, module or user carried out the action (the system module or a specific employee or customer).

You can understand the history of the subscription and answer customer inquiries about the past contract based on data.

  • Adjust columns: If you are missing important information in the tables or would like to slim down the view, click on the Edit Columns button at the top right of the respective table.
  • Note pagination: The detailed event history can be very long for long-lived contracts. Use the pagination at the bottom right of the table to access older entries or set the “positions per page” higher.

The tebio API provides its own endpoints for the programmatic evaluation of the history:

End pointMethodDescriptionOperationId
/v1/subscription/event-historyGETSearch and filter subscription event historysearchSubscriptionEventHistory
/v1/subscription/event-history/{uuid}GETRetrieve event history for a specific subscriptiongetSubscriptionEventHistory

In addition, the structured arrays for historical and planned breaks can also be read out using the generic retrieval of the subscription (GET /v1/subscription/{uuid}).