Listar Informadores

Lista todos os informadores cadastrados no sistema

Este endpoint é do tipo: Protected

Descrição

Lista todos os usuários com role de informador cadastrados no sistema com paginação e filtros por grupo, diocese e busca por nome.

Retorna apenas usuários com role de "informador"
Suporte a paginação com parâmetros page e per_page
Filtros por group_id, diocese_id e busca por nome
Retorna dados do usuário com role aninhada
Iniciais geradas automaticamente ignorando artigos e preposições
Requer autenticação JWT válida

Detalhes do Endpoint

VERBO

GET

URL BASE

http://api.provista.dev.nabrasil.org.br/v1

ENDPOINT

/informers

Parâmetros de Query

Parâmetro	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página (padrão: 1)
per_page	integer	Não	Itens por página (padrão: 12)
group_id	string (UUID)	Não	Filtrar por ID do grupo
diocese_id	integer	Não	Filtrar por ID da diocese
category_id	integer	Não	Filtrar por ID da categoria
search	string	Não	Buscar por nome, sobrenome, email ou nome completo do informador

Cabeçalhos

Parâmetro	Valor
Authorization	Bearer <token>
Accept	application/json

Exemplo de Requisição

GET /api/informers?page=1&per_page=12&group_id=uuid-do-grupo&category_id=5&search=João
Authorization: Bearer <token>
Accept: application/json

Respostas

Sucesso - 200

{
  "success": true,
  "data": [
    {
      "id": "uuid-user",
      "first_name": "João",
      "last_name": "da Silva",
      "email": "joao@example.com",
      "email_verified": true,
      "email_verified_at": "2025-10-29T09:15:30.000000Z",
      "blacklisted": false,
      "role": {
        "id": 2,
        "name": "Informador",
        "slug": "informador",
        "description": "Usuário informador com acesso limitado aos questionários"
      },
      "cpf": "12345678901",
      "phone": "(11) 99999-9999",
      "category": {
        "id": 5,
        "name": "Consultor diocesano",
        "description": "Descrição",
        "active": true
      },
      "treatment_pronoun": {
        "id": 1,
        "name": "Pe.",
        "description": "Padre",
        "active": true
      },
      "diocese": {
        "id": 10,
        "name": "Diocese Y",
        "state": "SP",
        "active": true
      },
      "process": {
        "id": "uuid-processo",
        "name": "Provisão Diocese X",
        "protocol": "PROV-2025-001"
      },
      "group": {
        "id": "uuid-grupo",
        "name": "Grupo 1",
        "color": "#845ADF",
        "description": "Descrição do grupo"
      },
      "created_at": "2025-10-27T10:00:00.000000Z",
      "updated_at": "2025-10-29T10:00:00.000000Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 12,
    "total": 1,
    "last_page": 1,
    "from": 1,
    "to": 1,
    "has_more_pages": false
  }
}

Nota: A resposta inclui os campos email_verified (booleano) e email_verified_at (data) para indicar se o email do informador está verificado, além de metadados de paginação e o campo blacklisted.

Erro - 401 (Token inválido)

{
  "success": false,
  "message": "Token inválido"
}

Condição: Token JWT inválido, expirado ou não fornecido

Códigos de Resposta

Código	Descrição
200	Lista de informadores retornada com sucesso
401	Token inválido ou expirado

Nunciatura Provista