> ## Documentation Index > Fetch the complete documentation index at: https://docs.base39.com.br/llms.txt > Use this file to discover all available pages before exploring further. # List users in the organization ## OpenAPI ````yaml /api-reference/openapi.json get /v2/users openapi: 3.1.0 info: title: Base39 API description: Base39 API version: 1.0.0 contact: name: Base39 Team url: https://base39.com.br email: suporte@base39.com.br termsOfService: https://base39.com.br/termos license: name: Proprietary url: https://base39.com.br/termos servers: - url: http://localhost:3000 description: Local - url: https://api.dev.base39.cloud description: Development - url: https://api.base39.com.br description: Production security: - OAuth2: [] tags: - name: pages description: Profiles and reports pages - name: pipelines description: Pipeline boards (kanban) of pages - name: blocks description: Blocks operations - name: search description: Search across content - name: targets description: Lookup targets via datasets - name: CognitoTriggers description: Cognito triggers paths: /v2/users: get: tags: - users summary: List users in the organization operationId: user_list parameters: - name: expand required: false in: query description: >- Comma-separated fields to expand. Supports selection with brackets (e.g., "createdBy,updatedBy" or "targets.company[icon,tradeName]"). schema: example: createdBy type: string - name: page_size required: false in: query description: Number of items to return per page schema: minimum: 1 maximum: 100 default: 20 example: 100 type: number - name: start_cursor required: false in: query description: >- Opaque cursor for pagination. Use the next_cursor from previous response. schema: example: >- eyJjcmVhdGVkX3RpbWUiOiIyMDI0LTExLTE1VDEwOjAwOjAwLjAwMFoiLCJpZCI6InBhZ2VfYWJjMTIzIn0= type: string responses: '200': description: List users in the organization content: application/json: schema: type: object properties: object: type: string example: list results: type: array items: $ref: '#/components/schemas/UserOutput' next_cursor: type: string nullable: true has_more: type: boolean type: type: string required: - object - results - has_more '401': description: Unauthorized components: schemas: UserOutput: type: object properties: object: type: string example: page description: Object type title: Object x-locale-pt-br-title: Objeto id: type: string example: p_abc123 description: Unique identifier title: ID x-locale-pt-br-title: ID createdAt: format: date-time type: string example: '2024-01-15T10:30:00.000Z' description: Creation timestamp title: Created at x-locale-pt-br-title: Criado em updatedAt: format: date-time type: string example: '2024-01-15T14:45:00.000Z' description: Last update timestamp title: Updated at x-locale-pt-br-title: Atualizado em createdBy: type: object example: object: user id: u_abc123 apiKeyId: bsk_abc123 description: Principal who created this object properties: object: type: string enum: - user - service_account example: user id: type: string example: u_abc123 apiKeyId: type: string example: bsk_abc123 title: Created by x-locale-pt-br-title: Criado por updatedBy: type: object example: object: user id: u_abc123 apiKeyId: bsk_abc123 description: Principal who last updated this object properties: object: type: string enum: - user - service_account - webhook - stream example: user id: type: string example: u_abc123 apiKeyId: type: string example: bsk_abc123 title: Updated by x-locale-pt-br-title: Atualizado por email: type: string description: User email address example: user@example.com nullable: true firstName: type: string description: User first name example: John nullable: true lastName: type: string description: User last name example: Doe nullable: true name: type: string description: User full name (virtual, concatenation of firstName + lastName) example: John Doe nullable: true picture: type: string description: User profile picture URL example: https://lh3.googleusercontent.com/a/photo.jpg nullable: true membershipStatus: type: string description: User membership status in the organization example: active enum: - active - waiting_approval - disabled last_login_at: type: string description: Last login timestamp (null if user has not logged in yet) example: '2025-11-21T19:00:00.000Z' format: date-time nullable: true last_activity_at: type: string description: Last activity timestamp for this organization membership example: '2025-11-21T19:00:00.000Z' format: date-time nullable: true role: type: string description: User role in the organization example: admin preferences: type: object description: User preferences example: currency_format: kmb nullable: true onboarding: type: object description: User onboarding state example: completedAt: '2026-04-09T23:10:00.000Z' nullable: true orgId: type: string description: Organization ID the user belongs to example: o_abc123 required: - object - id - createdAt - updatedAt - email - firstName - lastName - name - picture - membershipStatus - last_login_at - last_activity_at - preferences - onboarding - orgId securitySchemes: OAuth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://id.local.base39.cloud/oauth2/authorize tokenUrl: https://id.local.base39.cloud/oauth2/token scopes: profile: Read user profile email: Read user email openid: OpenID authentication description: OAuth2 Authorization Code flow ````