> For the complete documentation index, see [llms.txt](https://selenium-4.gitbook.io/nexus-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://selenium-4.gitbook.io/nexus-docs/service-domain/party-authentication/operacoes/main-1.md).

# Retrieve - Authenticated Party Details

| Campo              | Valor                                                           |
| ------------------ | --------------------------------------------------------------- |
| **Service Domain** | Party Authentication                                            |
| **BIAN Version**   | 14.0.0                                                          |
| **Operation**      | Retrieve Authenticated Party Details                            |
| **Method**         | GET                                                             |
| **API Name**       | Party Authentication API                                        |
| **Versão**         | v1.0.0                                                          |
| **Endpoint**       | `GET /v1/party-authentication/{partyAuthenticationId}/retrieve` |
| **Autenticação**   | Bearer Token (OAuth 2.0 / OIDC)                                 |

***

## 1. Descrição da Operação

A operação permite consultar os detalhes do Party (cliente) autenticado, incluindo o perfil de registo (`PartyDirectoryEntryProfile`) — nome, tipo de Party, identificações, contactos — e a referência de identidade emitida pelo banco (`BankIssuedIdentityReference`).

***

## 2. Cabeçalhos HTTP

| Header          | Tipo   | Obrigatório | Descrição          |
| --------------- | ------ | ----------- | ------------------ |
| `Authorization` | string | Sim         | Bearer Token.      |
| `Content-Type`  | string | Sim         | `application/json` |
| `Accept`        | string | Sim         | `application/json` |

***

## 3. Path Parameters

| Parâmetro               | Obrigatório | Descrição                               |
| ----------------------- | ----------- | --------------------------------------- |
| `partyAuthenticationId` | Sim         | Identificador da autenticação do Party. |

***

## 4. Payload de Resposta (Response)

### 4.1 Exemplo

```json
{
  "PartyReference": "148311",
  "PartyDirectoryEntryProfile": {
    "PartyName": {
      "Name": "Antonio Gaspar"
    },
    "PartyType": "Individual",
    "PartyIdentification": [
      {
        "PartyIdentificationType": "TaxID",
        "PartyIdentificationValue": "000010040MO003",
        "PartyIdentificationStatus": "Active"
      }
    ],
    "PartyContactDetails": [
      {
        "ContactType": "PhoneNumber",
        "PhoneNumbers": [
          {
            "PhoneNumberType": "Primary",
            "PhoneNumberValue": "+244 948088007"
          }
        ]
      }
    ],
    "BankIssuedIdentityReference": {
      "PartyIdentificationType": "InternetBankingID",
      "PartyIdentification": {
        "IdentifierValue": {
          "Value": "agaspar76"
        },
        "IdentifierIssuingAuthority": "Banco KEVE",
        "IdentifierStartDate": {
          "DateTimeContent": {
            "Text": "2025-08-12"
          }
        }
      }
    }
  }
}
```

### 4.2 Objecto Raiz

| Campo                        | Descrição                                   |
| ---------------------------- | ------------------------------------------- |
| `PartyReference`             | Identificador de referência do Party.       |
| `PartyDirectoryEntryProfile` | Perfil de registo do Party. Ver secção 4.3. |

### 4.3 Objecto: `PartyDirectoryEntryProfile`

| Campo                         | Descrição                                                    |
| ----------------------------- | ------------------------------------------------------------ |
| `PartyName.Name`              | Nome do Party.                                               |
| `PartyType`                   | Tipo de Party. Valores: `Individual` \| `Corporate`.         |
| `PartyIdentification[]`       | Identificações do Party. Ver secção 4.4.                     |
| `PartyContactDetails[]`       | Contactos do Party. Ver secção 4.5.                          |
| `BankIssuedIdentityReference` | Referência de identidade emitida pelo banco. Ver secção 4.6. |

### 4.4 Objecto: `PartyIdentification[]`

| Campo                       | Descrição                                                                |
| --------------------------- | ------------------------------------------------------------------------ |
| `PartyIdentificationType`   | Tipo de identificação. Valores: `NationalID` \| `TaxID` \| `CustomerID`. |
| `PartyIdentificationValue`  | Valor da identificação.                                                  |
| `PartyIdentificationStatus` | Estado da identificação. Valores: `Active` \| `Inactive`.                |

### 4.5 Objecto: `PartyContactDetails[]`

| Campo                             | Descrição                                                                           |
| --------------------------------- | ----------------------------------------------------------------------------------- |
| `ContactType`                     | Tipo de contacto. Valores: `PhoneNumber` \| `Email` \| `TaxID` \| `CustomerID`.     |
| `PhoneNumbers[].PhoneNumberType`  | Tipo do número de telefone. Valores: `Primary` \| `Secondary` \| `SecondSecondary`. |
| `PhoneNumbers[].PhoneNumberValue` | Número de telefone.                                                                 |

### 4.6 Objecto: `BankIssuedIdentityReference`

| Campo                                                          | Descrição                                                             |
| -------------------------------------------------------------- | --------------------------------------------------------------------- |
| `PartyIdentificationType`                                      | Tipo de identificação emitida pelo banco (ex.: `InternetBankingID`).  |
| `PartyIdentification.IdentifierValue.Value`                    | Valor do identificador (ex.: nome de utilizador de Internet Banking). |
| `PartyIdentification.IdentifierIssuingAuthority`               | Entidade emissora do identificador.                                   |
| `PartyIdentification.IdentifierStartDate.DateTimeContent.Text` | Data de início de validade do identificador.                          |