> 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/smart-id.md).

# Smart-ID

Smart-ID is a free app that serves as a convenient digital identity card. It can be used for secure authentication, digital signing and validation of agreements or transactions. It provides a method for verifying a person's identity online in a similar manner to presenting a physical identification document in person. Smart-ID is compatible with smartphones and tablets. It is accepted by state institutions, banks, and enterprises in Estonia, Latvia and Lithuania.

### What kind of data I will get

Smart-ID allows you to secure and authenticate your digital transactions, which may include personal data, financial data or any kind of sensitive information. For example, you can use it for secure online banking, e-services and legal transactions. The data processed includes  first and last name, date of birth, personal identification number and country.

### Input

User needs to provide individual document number.

```
{
    "documentNumber": "PNOEE-50001029996-MOCK-Q"
}
```

### Mock Input

Below you can find mock numbers which you can use to explore and test various features and behaviors of the application.

<table><thead><tr><th width="174">End Result</th><th width="96">Country</th><th width="293">Document Number</th><th>Comment</th></tr></thead><tbody><tr><td>OK</td><td><p>EE </p><p>LT </p><p>LV</p><p> BE</p></td><td><p>PNOEE-50001029996-MOCK-Q </p><p>PNOLT-50001029996-MOCK-Q </p><p>PNOLV-020100-29990-MOCK-Q </p><p>PNOBE-00010299944-MOCK-Q</p></td><td>Adult</td></tr><tr><td>OK</td><td><p>EE</p><p>LT</p><p>LV</p></td><td>PNOEE-30303039816-MOCK-Q PNOLT-30303039816-MOCK-Q PNOLV-030303-10215-MOCK-Q</td><td>User has other active account</td></tr><tr><td>OK</td><td><p>EE</p><p>LT</p><p>LV</p></td><td>PNOEE-50701019992-MOCK-Q PNOLT-50701019992-MOCK-Q PNOLV-010107-20007-MOCK-Q PNOLV-329999-88807-MOCK-Q</td><td>User age is under 18 (01.01.2007)</td></tr><tr><td>OK</td><td><p>EE</p><p>LT</p><p>LV</p></td><td>PNOEE-30303039903-MOCK-Q PNOLT-30303039903-MOCK-Q PNOLV-030303-10004-MOCK-Q</td><td>No numbers in names</td></tr><tr><td>OK</td><td>LV</td><td>PNOLV-311299-19993-MOCK-Q PNOLV-329999-99901-MOCK-Q</td><td>dateOfBirth in separate field</td></tr><tr><td>OK</td><td>LV</td><td>PNOLV-329999-99709-MOCK-Q</td><td>No dateOfBirth in separate field</td></tr><tr><td>USER_REFUSED _DISPLAYTEXTANDPIN</td><td><p>EE </p><p>LT </p><p>LV</p></td><td>PNOEE-30403039928-MOCK-Q PNOLT-30403039928-MOCK-Q PNOLV-030403-10024-MOCK-Q</td><td>v1 response USER_REFUSED<br></td></tr><tr><td>USER_REFUSED _VC_CHOICE</td><td><p>EE </p><p>LT </p><p>LV</p></td><td>PNOEE-30403039939-MOCK-Q PNOLT-30403039939-MOCK-Q PNOLV-030403-10032-MOCK-Q</td><td>v1 response USER_REFUSED</td></tr><tr><td>USER_REFUSED _CONFIRMATIONMESSAGE</td><td><p>EE </p><p>LT </p><p>LV</p></td><td>PNOEE-30403039946-MOCK-Q PNOLT-30403039946-MOCK-Q PNOLV-030403-10040-MOCK-Q</td><td>v1 response USER_REFUSED</td></tr><tr><td>USER_REFUSED<br><em>CONFIRMATIONMESSAGE</em><br>WITH_VC_CHOICE</td><td><p>EE </p><p>LT </p><p>LV</p></td><td>PNOEE-30403039950-MOCK-Q PNOLT-30403039950-MOCK-Q PNOLV-030403-10059-MOCK-Q</td><td>v1 response USER_REFUSED<br></td></tr><tr><td>USER_REFUSED _CERT_CHOICE</td><td><p>EE </p><p>LT </p><p>LV</p></td><td>PNOEE-30403039961-MOCK-Q PNOLT-30403039961-MOCK-Q PNOLV-030403-10067-MOCK-Q</td><td>v1 response USER_REFUSED<br></td></tr><tr><td>WRONG_VC</td><td><p>EE </p><p>LT </p><p>LV</p></td><td>PNOEE-30403039972-MOCK-Q PNOLT-30403039972-MOCK-Q PNOLV-030403-10075-MOCK-Q</td><td></td></tr><tr><td>TIMEOUT</td><td><p>EE </p><p>LT </p><p>LV</p></td><td>PNOEE-30403039983-MOCK-Q PNOLT-30403039983-MOCK-Q PNOLV-030403-10083-MOCK-Q</td><td></td></tr></tbody></table>

### Output

| Attribute      | Type   | Description                                          |
| -------------- | ------ | ---------------------------------------------------- |
| givenName      | string | First name of verified user.                         |
| surname        | string | Last name of verified user.                          |
| identityNumber | string | Identity number of verified user.                    |
| country        | string | Country of verified user.                            |
| dateOfBirth    | string | Date of birth of verified user in RRRR-MM-DD format. |

### Output Example

```
{
    "verification": {
      "givenName": "Jan",
      "surname": "Kowalski",
      "identityNumber": "50001029996",
      "country": "EE",
      "dateOfBirth": "2000-01-02"
    }
  }
```