Skip to main content

Get User Profile

Get the profile of a user via email address.

You can use this request to check if a user has a license for an application:

The Global Discovery Service API returns information based on the set of tapio-Applications that are assigned to the calling AAD-Application. Make sure that the AAD-Application you are using is assigned to the tapio-Application you want to check licenses for in my tapio.

To check if the User has a License for your tapio-Application you have to go through all Licenses of of all Subscriptions in the response and check if there is a License with the id of your tapio-Application (subscriptions[].licenses[].applicationId JMESPath).

Licenses can expire or be unassigned from a certain User or Machine. It is not recommended to poll the Global Discovery Service API and detect those changes yourself. Instead we encourage you to setup a CloudEvent endpoint and listen for License-related changes.

Path Parameters
  • email string required

    Email address



  • email string

    Email address

  • subscriptions object[]

    List of user profiles

  • role string

    User role

  • subscriptionId uuid

    Subscription id

  • parentSubscriptionId uuid

    Parent subscription id

  • name string

    Subscription name

  • tapioId string

    Tapio id

  • assignedMachines object[]

    Assigned machines

  • tmid string


  • deviceType string

    Possible values: [Unknown, Machine, SmartDevice]

    Device type

  • deviceSubType string

    Device sub-type. If Device type is set to "Machine", Device sub-type will only contain one the following values: "Unknown", "Edge", "Saw", "Cnc", "Sanding", "Drilling", "Assembly", "Storing", "Stock", "Sorting", "Shipping", "PreAssembly", "Lamination", "Moulding", "Packaging", "Handling"

  • displayName string

    Display name

  • manufacturerSerialNumber string

    Serial number given to the machine by its manufacturer.

  • onboardingDate date-time

    The date, when the machine has been added to the subscription

  • equipmentGroup object

    Information about a group in the context of a machine, assigned to it.

  • id string

    Id of the equipment group.

  • groupPosition int32

    Position of the machine within the group.

  • assignedApplications object[]

    List of assigned applications for this machine

  • id uuid

    Application id

  • subscriptionTypes string[]

    Subscription Types

  • subscriptionFeatures string[]

    Subscription Features

  • servicePartners object[]

    Service partners

  • subscriptionId uuid

    Subscription id

  • name string

    Service partner name

  • customerNumber string

    Customer number

  • parentSubscriptionId uuid

    Parent id

  • providerNo string

    Provider number

  • servicePartnerType string

    Possible values: [MachineService, SharpeningService]

    Service partner type

  • licenses object[]


  • licenseId uuid

    License id

  • applicationId uuid

    Application id

  • createdDate date-time

    License creation date

  • billingStartDate date-time

    Billing start date

  • billingInterval string

    Billing interval

  • licenseCount int32

    License count

  • equipmentGroups object[]

    Equipment groups

  • id string

    Equipment group id

  • parentId string

    Id of the parent equipment group, or null if there is no parent.

  • displayName string

    Display name

  • groupPosition int32

    Position of the machine within the group

  • placesCount int32

    Number of places in the equipment group

  • type string

    Possible values: [Group, Warehouse, Root]

  • servicePartnerType string

    Possible values: [MachineService, SharpeningService]

    Service partner type