# Consulta informações de um usuário

Consulta dados detalhados de um usuário a partir do identificador do Aut0.

Endpoint: GET /hub-api/users
Security: InternalAuth

## Query parameters:

  - `userId` (string, required)
    Identificador único do usuário (ID Aut0).
    Example: "auth0|1234567890abcdef12345678"

## Response 200 fields (application/json):

  - `person` (object)
    Informações pessoais do usuário

  - `person.id` (string)
    Identificador do usuário
    Example: "auth0|1234567890abcdef12345678"

  - `person.type` (string)
    Tipo da conta do usuário
    Example: "personal"

  - `person.document` (string)
    Documento (CPF)
    Example: "12345678900"

  - `person.email` (string)
    E-mail principal
    Example: "usuario.parceiro@exemplo.com"

  - `person.name` (string)
    Nome completo do usuário
    Example: "Maria Oliveira"

  - `person.phone` (string)
    Telefone de contato
    Example: "11999998888"

  - `person.address` (any)

  - `user` (object)
    Informações adicionais do usuário no Aprova

  - `user.role` (string)
    Cargo ou função do usuário
    Example: "Analista"

  - `user.linked_sectors` (array)
    Setores vinculados ao usuário

  - `user.linked_sectors.id` (string)
    Example: "507f1f77bcf86cd799439011"

  - `user.linked_sectors.name` (string)
    Example: "Setor de Licenciamento"

  - `user.assigned_permissions` (array)
    Permissões atribuídas ao usuário

  - `user.assigned_permissions.id` (string)
    Example: "process:view"

  - `user.assigned_permissions.name` (string)
    Example: "process:view"

  - `user.account_status` (string)
    Status atual da conta
    Example: "active"

  - `user.account_situation` (object,null)
    Situação da conta quando disponível

  - `user.account_situation.id` (string)
    Example: "situation-01"

  - `user.account_situation.name` (string)
    Example: "Conta regular"

  - `user.created_at` (string)
    Data de criação do usuário
    Example: "2025-06-01T12:00:00.000Z"

  - `user.last_login` (string)
    Data do último login
    Example: "2025-11-05T19:52:42.883Z"

  - `user.last_registration_update` (string)
    Data da última atualização cadastral
    Example: "2025-10-20T08:15:30.000Z"

  - `user.redirect_to` (string,null)
    ID da conta acolhedora quando aplicável

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad Request"

  - `message` (string)
    Example: "Este usuário pertence a outra organização"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "Unauthorized"

  - `message` (string)
    Example: "API Key is required"

## Response 404 fields (application/json):

  - `error` (string)
    Example: "Not Found"

  - `message` (string)
    Example: "User not found"