> ## Documentation Index > Fetch the complete documentation index at: https://docsnewgen.flexxible.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar usuários > Retorna uma lista paginada de usuários disponíveis dentro do escopo da organização. ## OpenAPI ````yaml /pt-BR/api-reference/openapi.pt-v2.json get /v2/organizations/{organization_id}/users openapi: 3.0.3 info: title: API Publica Portal version: 2.0.0 description: API pública REST para portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: - name: Atividade digital description: Criação de grupos de processos principais por organização - name: Roles description: Endpoint de creacion de roles de organizacion - name: Usuarios description: Endpoint de creacion de usuarios de organizacion - name: Grupos de workspaces description: Endpoints de gestión de grupos de workspaces - name: Workspaces description: Endpoint de eliminacion de workspaces de la organizacion - name: Aplicaciones instaladas description: Endpoint de detalle de aplicación instalada de la organización - name: Autenticación description: Endpoints de autenticación y contexto de sesión - name: Microservicios description: Detalle de microservicios por organizacion - name: Operaciones description: Consulta de detalle de operaciones por organización - name: Organización description: Operaciones de organización - name: Objetivos de política de parches description: Endpoints de gestión de objetivos de política de parches - name: Configuraciones de producto description: Endpoints de gestión de configuraciones de producto - name: Grupos de reporte description: Operaciones sobre grupos de reporte - name: Sesiones description: Endpoint de detalle de sesion de la organizacion - name: Tenants description: Endpoints de gestión de tenants paths: /v2/organizations/{organization_id}/users: get: tags: - Usuários summary: Listar usuários description: >- Retorna uma lista paginada de usuários disponíveis dentro do escopo da organização. operationId: get_users parameters: - name: organization_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador da organização. example: 507f1f77bcf86cd799439011 - name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: Número da página. - name: per_page in: query required: false schema: type: integer default: 100 minimum: 1 maximum: 100 description: Número de elementos por página. - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Nomes de campos de elementos de resposta separados por vírgulas para incluir. - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Expressão de filtro JSON sobre caminhos de campos de resposta filtráveis. Todos os campos do contrato são filtráveis. examples: simple: summary: Filtrar por nome de usuário value: '{"field":"name","op":"contains","value":"ana"}' complex-and: summary: Filtrar por departamento e método de login value: >- {"and":[{"field":"department","op":"eq","value":"support"},{"field":"email_login_enabled","op":"eq","value":true}]} complex-or-and: summary: Combinar filtragem por organização e e-mail value: >- {"and":[{"or":[{"field":"organization_id","op":"eq","value":"507f1f77bcf86cd799439011"},{"field":"organization_id","op":"eq","value":"507f1f77bcf86cd799439012"}]},{"field":"email","op":"contains","value":"@example.com"}]} created-at-and-role: summary: Filtrar por data de criação e papel value: >- {"and":[{"field":"created_at","op":"gte","value":"2025-01-01T00:00:00.000Z"},{"field":"role_id","op":"eq","value":"64f0c2a1b2d3e4f5060708aa"}]} - name: sort in: query required: false schema: type: string pattern: >- ^(id|name|surname|email|language|department|role_id|organization_id|created_at|created_by|email_login_enabled):(asc|desc)$ description: >- Expressão de ordem no formato :asc|desc. Todos os campos do contrato são ordenáveis. responses: '200': description: Usuários recuperados com sucesso. content: application/json: schema: $ref: '#/components/schemas/GetUsersResponseV2' examples: paginated_result: summary: Lista paginada com usuários value: has_next: true data: - id: 64f0c2a1b2d3e4f506070801 name: Ana surname: Lopez email: ana.lopez@example.com language: en-EN department: Support role_id: 64f0c2a1b2d3e4f5060708aa organization_id: 507f1f77bcf86cd799439011 created_at: '2025-12-01T10:30:00.000Z' created_by: 64f0c2a1b2d3e4f5060708bb email_login_enabled: true empty_result: summary: Nenhum usuário encontrado value: has_next: false data: [] '400': description: Parâmetros de solicitação inválidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Formato de filtros inválido value: error: message: Formato de filtros no valido code: bad_request details: filters debe ser una cadena JSON valida '401': description: Não autorizado ou a organização não é acessível. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Falha de acesso à organização value: error: message: No autorizado code: unauthorized '404': description: >- Recurso solicitado não encontrado dentro do escopo autorizado da organização. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: resource_not_found: summary: Recurso solicitado não encontrado value: error: message: No encontrado code: not_found '500': description: Erro interno do servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Falha não controlada value: error: message: Error interno del servidor code: internal_error components: schemas: GetUsersResponseV2: type: object properties: has_next: type: boolean description: Se há outra página disponível. data: type: array items: $ref: '#/components/schemas/UserByIdV2' required: - has_next - data ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error UserByIdV2: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador do usuário. organization_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador da organização associada ao usuário. name: type: string description: Nome do usuário. surname: type: string description: Sobrenome do usuário. email: type: string format: email description: Endereço de e-mail do usuário. language: type: string enum: - en-EN - es-ES - pt-BR - ca-ES - eu-ES description: Código de idioma preferido para o usuário. created_at: type: string description: Data de criação em formato ISO 8601. department: type: string nullable: true description: Departamento do usuário. role_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador do papel atribuído ao usuário. created_by: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador do usuário que criou o registro do usuário. email_login_enabled: type: boolean nullable: true description: Indica se o login por e-mail está habilitado para o usuário. required: - id - name - surname - email - language - created_at securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````