User Activities
Get the activities of a user during a specific time period, up to 180 days.
This endpoint queries the studies accessible to a given user, checks for either:
- studies that were created in the given time period, or
- studies that had additional discoveries run in the given time period, or
- studies that were last published in the given time period,
and returns a object including the
- Team and Market Collection ID that allows the user’s access to the market,
- the Market ID,
- the Market Title,
- the draft/published status of the market,
- the creation and publish date of the market,
- the number of companies in the market by their review and published status, and
- the discovery history of the market including timestamps for each.
This endpoints serves as a starting point for a management user to generate statistics of a user’s usage and utilisation pattern of the platform.
Query
The UUID of the user whose activities you want to retrieve.
uuid
or the email
parameter can be provided at a time.The email of the user whose activities you want to retrieve.
email
SAML attribute.Ensure you include all the necessary components for a strict match, such as any suffixes in the
first.last+suffix@your.domain
convention.uuid
or the email
parameter can be provided at a time.The number of days to look back for the activities.
Only one of
days
or start
and end
pair can be provided at a time.The start date of the period to look for the activities.
YYYY-MM-DD
ISO 8601 format.Only one of
days
or start
and end
pair can be provided at a time.The end date of the period to look for the activities.
If not provided, but start
is provided, the end date will be set to the current date.
YYYY-MM-DD
ISO 8601 format.Only one of
days
or start
and end
pair can be provided at a time.Response
The time at which this report was generated.
This will be in the ISO 8601 format, i.e. YYYY-MM-DDTHH:MM:SS.sssZ
, in UTC timezone.
The period for which the activities were captured.
This simply mirrors the query parameters provided.
The list of markets that the user interacted with during the capture period.
Markets should be unique by their marketId
.
Each of them contains the following fields:
This object contains the details of a single market.
The ID of the team that the user belongs to, which allowed the user access to this market.
The ID of the market collection that the user belongs to, which allowed the user access to this market.
This is typically attached to the team above.
The ID of the market.
The title of the market.
The status of the market.
This can be either draft
or published
:
draft
: Discoveries had been run, but the market has not been published, and the companies had not been enriched.marketPublishedDate
will benull
.published
: The market has been published, and the companies had been enriched;marketPublishedDate
will be set.
The time at which the market was created.
This will be in the ISO 8601 format, i.e. YYYY-MM-DDTHH:MM:SS.sssZ
, in UTC timezone.
Typically the market is created just before the first Discovery is run, in order to receive the companies found in the Discovery. The Discoveries will have a different timestamp of their own.
The time at which the market was published.
This will be in the ISO 8601 format, i.e. YYYY-MM-DDTHH:MM:SS.sssZ
, in UTC timezone.
This will be null
if the market is still in draft status.
The number of companies in the market by their review and published status.
This is a overview of the companies in the market - this is not affected by the filters applied to the request.
The history of the discoveries run in the market.
Each of them contains the following fields:
The user who ran the discovery.
This is the user who had access to the market, and ran the discovery.
The role of the user in the market.
Possible values are:
"manufacturer"
- physical product manufacturing, e.g. a car manufacturer"distributor"
- physical product distribution, e.g. a car dealership"service provider"
- contractor or provider of pre-defined services, e.g. a car repair shop"consultant"
- consultants or advisers not themselves participating in the market, but offers advice to those who do, e.g. a motor regulatory consultant
This is a hint to the discovery process and does not guarantee that all returned companies will fit this role. If insufficient companies are found, the search will be broadened to include other roles.
The seed domains used in the discovery.
These domains are guaranteed to be included in the results of the discovery, and do not count towards the total number of companies found.
The locations of the user in the market.
This is an array of objects, each representing a location of the user in the market.
A location object representing a location to perform a search in.
If the object is empty, it means a global search is to be performed.
The country code of the location.
This is the ISO 3166-1 alpha-2 country code.
The number of companies desired in the discovery.
The constraints applied in the discovery.
This is an object containing the constraints applied in the discovery.
Whether this is a discovery that involves a market search.
If the user manually added a company, this will be false
.
The time at which the discovery was run.
This will be in the ISO 8601 format, i.e. YYYY-MM-DDTHH:MM:SS.sssZ
, in UTC timezone.
The keywords used by the user in the discovery.