# Conference Data Module Structure

This reference describes the structure of the data returned by the [`conferenceData`](/products/liveidplus/2.1-test/enterprise/get-started/data-retrieval) API. The response contains the personal data collected during the call and a per-module object describing the outcome of each step.

## Response top-level fields

The `data` payload returned by `conferenceData` contains the following properties:

| Property | Description |
|  --- | --- |
| `data` | Object containing the personal data collected during the call. |
| Module ID | Each module instance is keyed by a unique ID (e.g. `39f62641-b36b-11e9-b4b0-0a0570fb6dbc`). The value follows the [basic module structure](#basic-module-structure); some modules use a [custom structure](#custom-module-structure). |
| `endPattern` | Closing status of the video recognition process. See [end pattern values](#end-pattern-values). |


### `data` example


```json
"data": {
  "user_1": {
    "tel": {
      "label": "Cellphone",
      "order": 3,
      "value": "<cell number>",
      "datetype": "tel",
      "required": true
    },
    "name": {
      "label": "Name",
      "order": 0,
      "value": "Mario",
      "datetype": "text",
      "required": true
    }
  }
}
```

### End pattern values

| Value | Description |
|  --- | --- |
| `N` | Process closed correctly. |
| `S` | Process suspended by operator. |
| `A` | Process aborted by operator due to errors. |


## Basic module structure

All modules share a standard structure with the following fields:

| Property | Description |
|  --- | --- |
| `date` | Date of validation. |
| `valid` | Describes whether the module is valid. |
| `moduleName` | Module description / identifier (e.g. `liveid-welcome`). |
| `textDataLog` | Internal log. |


**Example**


```json
"39f62641-b36b-11e9-b4b0-0a0570fb6dbc": {
  "date": "2019-11-14T17:21:11+01:00",
  "valid": true,
  "moduleName": "liveid-welcome",
  "textDataLog": "--------------------------\nModulo-Benvenuto moduleName:liveid-welcome date:2019-11-14T17:21:11+01:00 valid:true\n--------------------------"
}
```

## Custom module structure

Some modules return a custom structure in addition to the basic fields.

### Photo module

The Photo module returns a `collection` array of photo categories.

| Property | Description |
|  --- | --- |
| `collection` | (Array) Contains one or more photo *categories*. |
| `collection[].id` | (String) Category identifier. |
| `collection[].text` | (String) Category description. |
| `collection[].photos` | (Array) Contains one or more photo entries for the category. |
| `collection[].extras` | (Object, optional) Extra information for the category (e.g. `{"type": "PA"}`). |
| `collection[].photos[].id` | (String) Progressive photo identifier — must follow the `photos[]` index. |
| `collection[].photos[].path` | (String) Photo link. |
| `collection[].photos[].text` | (String) Photo description. |


**Example**


```json
"collection": [
  {
    "id": "FACE",
    "text": "Viso",
    "photos": [
      {
        "id": "0",
        "path": "..\\uploads\\caTestLiveID\\79055461-078c-11ea-bbc3-02199d9d18f4\\790d7ac7-078c-11ea-bbc3-02199d9d18f4\\ModuleFace\\199301ec4318429b8894eb603ac0989b_photo_20191115_105729799.png",
        "text": "1"
      },
      {
        "id": "1",
        "path": "..\\uploads\\caTestLiveID\\79055461-078c-11ea-bbc3-02199d9d18f4\\790d7ac7-078c-11ea-bbc3-02199d9d18f4\\ModuleFace\\199301ec4318429b8894eb603ac0989b_photo_20191115_105734493.png",
        "text": "2"
      }
    ]
  }
]
```