Listar as pessoas cadastradas

Esse endpoint é responsável por retornar uma lista paginada das pessoas cadastradas. É possível realizar uma série de filtros, ordenações e navegar entre as páginas de resultados.

As informações sensíveis serão retornadas mascaradas por questão de segurança, porém, nesse endpoint é possível obter o ID da pessoa.

Parâmetros da Requisição

  • personId (string/uuid v4): ID para filtro de uma Pessoa.
  • taxpayerId (string): Nº do CPF ou CNPJ da pessoa.
  • search (string): Campo para busca textual.
  • sort (string): Campo para ordenação dos resultados. Possíveis valores: id, createdAt, taxpayerId.

Resposta

Se a requisição for processada com sucesso será retornado um código 200 e um JSON no seguinte formato:

  • content(object list): Objeto contendo a lista com o resultado do filtro realizado.
  • hasNext (boolean): Campo para indicar se tem uma próxima página.
  • totalElements (int): Quantidade total de registros retornados para a busca realizada.
  • totalPages (int): Quantidade total de páginas retornadas para a busca realizada.
Objeto 'content'
  • id (string/uuid v4): ID do cadastro da pessoa.
  • name (string): O nome completo da pessoa.
  • personType (string): O tipo da pessoa. Possíveis valores: NATURAL, LEGAL.
  • createdAt (datetime): Data e hora do cadastro.
  • businessType (string): Tipo da empresa, se pessoa for do tipo jurídica. Possíveis valores: FUND, MANAGER, SECURITIZER, CONSULTANT, CUSTODIAN, ADMINISTRATOR, OTHERS.
  • legalName (string): Razão social, se pessoa for do tipo jurídica.
Exemplo de JSON:
{
    "content": [
        {
            "id": "",
            "personType": "NATURAL",
            "name": "",
            "createdAt": "",
            "businessType": "CUSTODIAN",
            "legalName": {}
        },
        {
            "id": "",
            "personType": "LEGAL",
            "name": "",
            "createdAt": "",
            "businessType": "OTHERS",
            "legalName": {}
        }
    ],
    "hasNext": "",
    "totalElements": "",
    "totalPages": ""
}

Language
Credentials
Bearer
URL
Click Try It! to start a request and see the response here!