Users Endpoint

GET https://api.neuro-id.com/v4.1/sites/{site_id}/profiles/users/{registered_user_id}

The Profiles endpoint serves complete profile data for a user session. The Profiles endpoint response will vary depending on the NeuroID product(s) purchased. The table below outlines which blocks of data are returned for each NeuroID Product.

Product	Signals Array	Signal Attributes	Interaction Attributes
ID Crowd Alert	No API Access
ID Orchestrator	Yes	No	No
ID Attributes	Yes	Yes	Yes

Signals Array

The signals block in the API response consists of an array of signals, each with the following fields:

• model: The name of the signal.
• label: The classification label for the signal. E.g., for the Intent signal, the possible labels are genuine, neutral, risky, and insufficient data.
• attributes: The lower-level data elements used to arrive at the classification for a signal. Only available for customers who have purchased ID Attributes. A block of associated attributes are added to each element in the signals array under the heading attributes. The keys of this map are strings, while the values could be different data types.

Interaction Attributes

The interactionAttributes block in the API response contains high-level summary statistics for the given session, including session duration, counts of interactions with various field groupings, and cardinalities for session identifiers. These Interaction Attributes are presented within the profile block of the API response. Only customers who have purchased ID Attributes will receive Interaction Attributes.

📘

Best Practices

1. Check the HTTP status code. If it's not 200, there was an error. Check response["status"] and response["message"] for more information on the error.
2. If the HTTP status code is 200, check response["status"].
   • If response["status"] is SUCCESS, the request was successful.
   • If response["status"] is NOT_ENOUGH_INTERACTION_DATA or SITE_NOT_CONFIGURED, then response["signals"] should not be trusted as the model has low signal fidelity.
3. Assuming the response is 200 and SUCCESS, iterate through the response["profile"]["signals"] array to find the signal["model"] you're interested in.
4. The signals array does not have a fixed length or order. Do not assume the length or order is fixed.

👍

Try It!

To access the API, you must use a valid API Key available in the NeuroID Portal by navigating to Settings > API Keys.

The following Site Id and Identity Id combinations may be used with a valid API Key to retrieve test data from the API.