> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/api-rest/identity-api/identity-api-reference/onboarding/civil-registry/proof-of-address.md).

# Comprovante de endereço

Serviço de verificação de **comprovante de endereço** com cobertura global.

### Endpoint

```
POST /civil-registry/proofofaddress
```

### Autenticação

| Tipo    | Localização | Nome          |
| ------- | ----------- | ------------- |
| API Key | Cabeçalho   | **x-api-key** |

### Exemplo de solicitação

```bash
curl --location '{IDENTITY_API_BASE_URL}/civil-registry/proofofaddress' \
--data-raw '{
  "TransmissionReference":"",
  "Actions":"Check,Verify",
  "AddressOptions":"",
  "EmailOptions":"",
  "PhoneOptions":"",
  "NameOptions":"NameHint:DefinitelyFull",
  "Options":"",
  ...
}' \
--header 'x-api-key: {API_KEY}'
```

### Respostas

#### `200` Sucesso

#### Exemplo de resposta

```json
{
  "Address": {
    "AddressKey": "{{addressKey}}",
    "AddressLine1": "{{addressLine1}}",
    "AddressLine2": "{{addressLine2}}",
    "AddressLine3": "{{addressLine3}}"
  },
  "Email": {
    "BreachCount": "",
    "DateChecked": "8/24/2023 9:51:25 PM",
    "DeliverabilityConfidenceScore": "55",
    "DomainAddress1": ""
  },
  "Identity": {
    "AccountNumber": {
      "Validated": ""
    },
    "BusinessInformation": {
      "ID": "",
      "Name": "",
      "RegistrationDate": "",
      "Status": "",
      "Type": ""
    },
    "Confidence": "High",
    "Datasources": [
      {
        "DatasourceName": "Credit-1",
        "Messages": [
          {
            "Description": "Primeiro nome/nome próprio correspondente",
            "ResultCode": "KV03"
          },
          {
            "Description": "Foi feita correspondência completa com a inicial do primeiro nome",
            "ResultCode": "KV31"
          },
          {
            "Description": "Sobrenome correspondente",
            "ResultCode": "KV04"
          }
        ],
        "Results": "KV03,KV31,KV04,KV01,KV10,KV11,KV12,KV13,KV14"
      }
    ],
    "DateOfBirth": "{{dateOfBirth}}",
    "NationalID": "{{nationalId}}",
    "Results": "KV03,KV31,KV04,KV01,KV10,KV11,KV12,KV13,KV14",
    "WatchlistPersons": "",
    "Watchlists": {
      "Articles": [],
      "Hit": "",
      "ReportLink": "",
      "Sources": []
    }
  },
  "Name": {
    "Company": "",
    "Gender": "",
    "Gender2": "",
    "NameFirst": "{{nameFirst}}"
  },
  "Phone": {
    "AdministrativeArea": "",
    "CallerID": "",
    "Carrier": "EE Limited (Orange)",
    "CountryAbbreviation": "GB"
  },
  "Results": "",
  "TransactionID": "{{transactionId}}",
  "TransmissionReference": "",
  "Version": "7.2.0.1214"
}
```

#### `400` Solicitação inválida

```json
{
  "status": 400,
  "title": "Solicitação inválida",
  "detail": "Requisição inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}
```

#### `401` Não autorizado

```json
{
  "message": "Não autorizado"
}
```

#### `403` Acesso negado

```json
{
  "Message": "O usuário não está autorizado a acessar este recurso com uma negação explícita"
}
```

#### `502` Gateway inválido

```json
{
  "status": 502,
  "title": "Gateway inválido",
  "detail": "O servidor recebeu uma resposta inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}
```

#### `504` Gateway Timeout

```json
{
  "message": "A solicitação do Endpoint excedeu o tempo limite"
}
```