# Subject object

A subject represents a human being who is the subject of a [record](/cortex-api/records.md) (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](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) 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](/cortex-api/subjects/getdemographicattributes.md) 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

```javascript
{
    "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"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://emotiv.gitbook.io/cortex-api/subjects/subject-object.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.