Subject object

A subject represents a human being who is the subject of a record (ie an experiment).

Description

A subject object includes these fields:

Name	Type	Description
subjectName	string	The name of the subject.
dateOfBirth	string	The date of birth of the subject. The format is "YYYY-MM-DD", e.g. "1980-12-25".
sex	string	Can be "M", "F" or "U". These letters stands for male, female and unknown respectively.
experimentsCount	number
countryCode	string	The Alpha-2 ISO code of the country the subject lives in.
countryName	string	The name of the country the subject lives in.
state	string	The state the subject lives in.
city	string	The city the subject lives in.
attributes	array of objects	A list of demographic attribute objects. See below.

Demographic attribute object

The field attributes is a list of attributes. A demographic attribute is an object with 2 fields:

Name	Type	Required	Description
name	string	yes	The name of the attribute.
value	string	yes	The value of the attribute.

You must call getDemographicAttributes to know what are the valid attribute names, and what are the possible values for each attribute.

For example, to tell that the subject is right handed, you can add the attribute { "name":"Handedness", "value":"Right"}

Example

{
    "attributes": [
        {
            "name": "Handedness",
            "value": "Left"
        },
        {
            "name": "Education",
            "value": "Master's degree"
        }
    ],
    "city": "London",
    "countryCode": "GB",
    "countryName": "",
    "dateOfBirth": "1980-12-25",
    "experimentsCount": 3,
    "modifiedDatetime": "2019-07-01T11:23:11.644+07:00",
    "sex": "F",
    "state": "",
    "subjectName": "Alice Smith"
}