Skip to content

Search subscription

In the tebio business portal you have various ways to find a specific subscription. Many users look for a subscription through the associated customer. A direct subscription search is also available.

Finding a subscription is the first step for many administrative tasks, such as pausing, canceling, or switching products. Which search method you choose depends on what information you have:

  • You know the customer, for example name, email address or company: Use method 1 via the customer view.
  • You have a subscription reference, for example from a support ticket: Use method 2 via the direct subscription search.
  • You need access to the tebio business portal.
  • For the direct subscription search: The subscription must have already been created in the system. Important: If a future start date was specified when ordering, the subscription may not yet exist and cannot yet be found using the direct search. In this case you will only find the waiting order in the customer file.

Way 1: Customer-based search (CRM approach)

Section titled “Way 1: Customer-based search (CRM approach)”

This approach is often helpful in everyday life because it directly shows the customer context.

  1. Click on Customers in the main menu.
  2. Search for the person or company you want (e.g. by name or email address).
  3. Open the customer file by clicking on the hit.
  4. The Subscriptions tab is open by default when calling a customer.
  5. You’ll see a list of this customer’s active, paused, or canceled subscriptions.

If you don’t want to search for a specific customer but want to filter directly by subscriptions, use this method.

  1. In the main menu, click Subscriptions or Subscriptions, depending on the name in your portal.
  2. The global list view of all subscriptions in your system opens.
  3. Use the search and filter fields at the top to narrow down the list:
    • Product name: Finds subscriptions for a specific product.
    • Subscription Reference: Use this field if you are looking for a specific subscription or subscription reference. Enter the specific reference here.
    • Customer/Partner: Filters based on whether the subscription is assigned to a customer or sales partner.
    • Status: Filters subscriptions by status, for example paused, suspended, or disabled.

Once you have found the subscription you are looking for (whether via route 1 or route 2), simply click on the relevant list entry.

This opens the detailed view of the subscription. There you can see important metadata, upcoming events and previous event history.

(Note: You can find out how to work in the detailed view and modify contracts in the article Edit subscription.)

  • Search without hits: If you enter a subscription reference and don’t get a hit, check the status filter. Deactivated or canceled subscriptions may be hidden in standard views. In this case, delete the status filter (empty field) to search across all historical contracts.
  • Customer vs. Partner Agreement: Subscriptions that are assigned to a sales partner (e.g. for an agency collective billing) only appear in the search if the “Customer/Partner” dropdown is configured accordingly.

For external systems or headless integrations, search and retrieval functions are available via the API:

End pointMethodDescriptionOperationId
/v1/subscriptionGETSearch subscriptions based on search parameterssearchSubscription
/v1/subscription/{uuid}GETGet details of a subscriptiongetSubscription
/v1/subscription/extSubscriptionRef/{extSubscriptionRef}GETRetrieve subscription using an external referencegetSubscriptionByExtSubscriptionRef