> For the complete documentation index, see [llms.txt](https://docs.transactionlink.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.transactionlink.io/docs/v1/integrations/infocamere/company-profile/list-persons.md).

# List persons

### Input

User needs to provide search phrase. The search phrase should be detailed enough to find a specific person, in the case of generic search phrases, an error is returned.

<table><thead><tr><th width="148">Attribute</th><th width="259">Type</th><th>Description</th></tr></thead><tbody><tr><td>search</td><td>String</td><td>Search phrase (at least 3 characters)</td></tr><tr><td>tradeBoards</td><td>String</td><td>Comma separated values which symbols of Italian Chambers of Commerce that narrow searching scope eg. <code>MI,BR,PC</code> (optional)</td></tr><tr><td>birthDate</td><td>String</td><td>Person birth date in format YYYY-MM-DD. <br>Either <code>birthDate</code> or <code>birthyear</code> can be provided. (optional)</td></tr><tr><td>birthYear</td><td>String </td><td>Person birth year in format YYYY.<br>Either <code>birthDate</code> or <code>birthyear</code> can be provided. (optional)</td></tr></tbody></table>

### Output

#### PersonList

Contains details about individual people.

| Attribute | Type  | Description                                                                  |
| --------- | ----- | ---------------------------------------------------------------------------- |
| people    | Array | An array of objects containing detailed information about individual people. |

**People**

An array of objects containing detailed information about individual people.

| Attribute  | Type   | Description                                            |
| ---------- | ------ | ------------------------------------------------------ |
| personId   | Number | Sequence number                                        |
| personData | Object | Contains detailed information about a specific person. |

**PersonData**

Contains detailed information about a specific person.

| Attribute                  | Type   | Description                           |
| -------------------------- | ------ | ------------------------------------- |
| surname                    | String | The surname of the person.            |
| name                       | String | The name of the person.               |
| provinceOfBirth            | String | The province code of birth.           |
| descriptionOfBirthProvince | String | Description of the province of birth. |
| dateOfBirth                | String | The date of birth of the person.      |
| taxCode                    | String | The tax code of the person.           |
| alternateCode              | String | Alternate code of the person.         |

```json
{
    "infocamere": {
        "personList": {
            "people": [
                {
                    "personId": 1,
                    "personData": {
                        "surname": "ACUTO",
                        "name": "FRANCESCO",
                        "provinceOfBirth": "CT",
                        "descriptionOfBirthProvince": "CATANIA",
                        "dateOfBirth": "1990-08-10",
                        "taxCode": "CTAFNC90M10B428U",
                        "alternateCode": "CTAFNC90M10B428U"
                    }
                }
            ]
        }
    }
}
```