Profiles vs. Accounts

While primarily an issue when issuing the raw APIs rather than the _query APIs, there can be some confusion when dealing with values that represent the ID of an individual rather than the name.

In Vitruvi, there are 2 data models: /api/v1/raw/core/profile/ is the collection of user profiles while /api/v1/raw/core/account/ is the collection of user accounts.

Where any other entity returns the ID of an individual, it is important to note that this refers to the profile ID and NOT the account ID.

Unfortunately, data from both entities is often needed. The account entity contains the individuals name and email address, while the profile entity contains the user's license tier as well as additional personal details such as their address, billing rates and manager/supervisior.

It is therefore often required to link the data from the two entities when querying data using the raw APIs using the profile.account_id field in order to resolve the name of individuals to the profile ID returned by other endpoints.