# Identities (obsolete)

{% hint style="warning" %}
This feature is obsolete. Please refere to [account-ownerships](https://docs.powens.com/api-reference/products/data-aggregation/account-ownerships "mention").
{% endhint %}

## API endpoints

{% hint style="success" %}
Authentication: endpoints listed in this page *require* [header authentication](https://docs.powens.com/api-reference/overview/authentication) with a *user token*.
{% endhint %}

## List identities

<mark style="color:blue;">`GET`</mark> `https://{domain}.biapi.pro/2.0/users/{userId}/identities`

#### Path Parameters

| Name                                     | Type            | Description             |
| ---------------------------------------- | --------------- | ----------------------- |
| userId<mark style="color:red;">\*</mark> | Integer or "me" | ID of the related user. |

{% tabs %}
{% tab title="200: OK List of identities" %}
Response body: [#identitieslist-object](#identitieslist-object "mention")
{% endtab %}
{% endtabs %}

## Get identity

<mark style="color:blue;">`GET`</mark> `https://{domain}.biapi.pro/2.0/users/{userId}/identities/{identityId}`

Get a single identity by ID.

#### Path Parameters

| Name                                         | Type            | Description             |
| -------------------------------------------- | --------------- | ----------------------- |
| userId<mark style="color:red;">\*</mark>     | Integer or "me" | ID of the related user. |
| identityId<mark style="color:red;">\*</mark> | Integer         | ID of the identity.     |

{% tabs %}
{% tab title="200: OK Identity details" %}
Response body: [#identity-object](#identity-object "mention")
{% endtab %}
{% endtabs %}

## Data model

### *IdentitiesList* object

| Property     | Type                                           | Description         |
| ------------ | ---------------------------------------------- | ------------------- |
| `identities` | Array of [*Identity*](#identity-object) object | List of identities. |

### *Identity* object

<table><thead><tr><th width="183">Property</th><th width="165.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>Integer</td><td>ID of the identity.</td></tr><tr><td><code>id_connection</code></td><td>Integer</td><td>ID of the connection the identity was fetched from.</td></tr><tr><td><code>id_user</code></td><td>Integer</td><td>ID of the user.</td></tr><tr><td><code>id_source</code></td><td>Integer</td><td>ID of the source the identity was fetched from.</td></tr><tr><td><code>first_name</code></td><td>String or null</td><td>First name of the user, <code>null</code> if not returned by the institution.</td></tr><tr><td><code>last_name</code></td><td>String or null</td><td>Last name of the user, <code>null</code> if not returned by the institution.</td></tr><tr><td><code>full_name</code></td><td>String or null</td><td>Full name of the user has it is returned by the institution, <code>null</code> if not returned by the institution.</td></tr><tr><td><code>last_update</code></td><td>DateTime</td><td>Date and time when the identity was last updated.</td></tr><tr><td><code>ibans</code></td><td>Array of strings</td><td>List of IBANs returned by the connection.</td></tr></tbody></table>