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

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

{
  "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

{
  "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

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

403 Acesso negado

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

502 Gateway inválido

{
  "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

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