/members endpoint is available for you to add or update your members in our system. It also allows you to see what information we have collected about your members through our pre-screening process, or to remove members and their associated data.
We do not require you to send your member data to us in advance, unless you plan to utilize any endpoints in which we attempt to evaluate a member for a specific target. However, we do require that you send a unique member identifier to us for each member within the survey URL. The variable name and procedures for doing this will be discussed as a part of your on-boarding process.
All of the API endpoints provided utilize your member id. We do not expose our internal ids to you, and consequently do not require you to map our internal ids to your members. We hope that this will simplify your integration with our API.
By utilizing your member ID through the API and through the target survey URLs, we are able to accurately match your members to their data when they arrive at our site. This simplifies the pre-screening process and provides a better member experience because we will not ask your member to answer any questions for which we already have a stored response. The more data you provide up front, or the more data we collect on repeat visits, the better the experience for your members!
|#_links||Object containing links to related resources|
|#_metadata||Metadata describing this resource|
|integer||The ID provided by you for this member|
Member's email address
Member's primary language. Refer to the list of valid language codes.
Member's first name
Member's last name
|date||Member's full birth date.|
|Address||Object containing the member's address information.|
Links to related resources. Links are provided only in cases where the linked resource exists in the context of this target.
Self-referencing link to the current object
|Link||Link to the acceptable response values for this demographic|
|datetime||When this member was created|
|datetime||When the last modifications were made to this member|
|datetime||Based on the member status, the date/time when this member will again be eligible to participate in our surveys.|
Typically we only collect country and postal code, and country is the only information required for every member. Note that we may run a validation on postal codes submitted, and may reject data that we deem invalid.
You may only submit country, postal code, and street address through this API. Any other address information shown may be derived by Critical Mix based on other information collected. We reserve the right to run additional validations and collect additional information about a member's address as required for specific targets. In the event that a project requires additional PII, it will be clearly indicated in the targetPii data element of the targetCriteria. Even though we do not allow you to set this additional data directly, we do make the data available for you to fetch via GET requests. This allows us to be transparent to you about additional data we have stored about your members in the event there are any privacy concerns.
|enumeration||This is the only part of the address that is required for all members. See Countries for the list of acceptable country codes.|
This should only contain data that is typically contained in address lines 1 and 2, such as street name and direction, building number, apartment, suite, etc. It should NOT contain personal or business names, city, state, province, region, or postal code. You may choose not to send this data initially. But, as with all other data points, we will collect the data as a part of our pre-screening process if the member is evaluated for a project that requires additional PII. Refer to the note above for additional information.
City, as determined by Critical Mix based on Postal Code. This may be null unless we have chosen to run additional validations on the provided Postal Code.
State for US Residents, as determined by Critical Mix based on Postal Code. This may also contain region or province information for members from other countries. This data will only be populated if the member has been evaluated for a target which requires additional PII to be collected. Please refer to the note above for more information.
Postal Code is not required. However, for some countries, most targets will require postal code to be collected as a part of the pre-screening process. We will collect this information as needed.
|date||For US members only, this data may be populated if we have the member's full address and have run additional data validations to determine this value.|
|address||For US members only, this data may be populated if we have the member's full address and have run additional data validations to determine this value.|
Basic information about your members