> ## Documentation Index > Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt > Use this file to discover all available pages before exploring further. # List Users in a Workspace > List all users in your Zeeg workspace, including their roles, slugs, and email addresses. Supports per_page pagination. ## OpenAPI ````yaml GET /organizations/users openapi: 3.0.0 info: title: Zeeg Public API description: >- Zeeg public API documentation. ## Authentication All endpoints require a Bearer token. You can generate an API token from [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access). Each token is scoped to specific permissions (e.g. `events:read`, `webhooks:write`). Make sure your token has the required scopes for the endpoints you want to use. ## Recommended Headers We recommend including the `Accept: application/json` header in all API requests to ensure you receive JSON responses. version: 2.0.0 x-logo: url: https://app.zeeg.me/img/logo-dark.2ca83593.svg backgroundColor: '#f7f7f9' altText: zeeg contact: name: Zeeg Support email: support@zeeg.me url: https://zeeg.me/en/contact license: name: Proprietary url: https://zeeg.me/en/legal/terms termsOfService: https://zeeg.me/en/legal/terms servers: - url: https://api.zeeg.me/v2 description: Production security: - bearer: [] tags: - name: Scheduled Events description: Management of events scheduled via Zeeg - name: Scheduling Pages description: Scheduling pages information and management - name: Availability Schedule description: Read and change availability for users - name: Webhooks description: Webhooks management - name: Notes description: Notes for scheduled events - name: Workspaces & Teams description: Workspace users and team member management - name: AI Agent description: AI Agent integration endpoints - name: Payloads description: Webhook payload schemas - name: CRM - Objects description: >- Discover the schema of CRM objects (standard and custom) including all attribute definitions - name: CRM - Companies description: Create, read, update, and delete CRM company records - name: CRM - People description: Create, read, update, and delete CRM person records paths: /organizations/users: get: tags: - Workspaces & Teams summary: List users in a workspace description: |- Returns a paginated list of users in the authenticated user's workspace. Required scopes: `admin:full` or `users:read`. operationId: get-organizations-users parameters: - schema: type: integer default: 20 minimum: 1 maximum: 100 in: query name: per_page description: Number of results per page. - schema: type: integer default: 1 minimum: 1 in: query name: page description: Page number. responses: '200': description: OK content: application/json: schema: type: object properties: collection: type: array items: type: object properties: uuid: type: string format: alphanumeric-id description: Alphanumeric user identifier (e.g. QK566D4X49E8X78) example: QK566D4X49E8X78 isActive: type: boolean description: Whether the user account is active email: type: string format: email firstName: type: string lastName: type: string name: type: string description: Full display name slug: type: string language: type: string url: type: string format: uri description: User's Zeeg page link avatarUrl: type: string nullable: true timezone: type: string description: IANA timezone identifier role: type: string enum: - owner - admin - user teams: type: array items: type: object properties: uuid: type: string format: uuid description: Team UUID title: type: string slug: type: string url: type: string format: uri description: Team's Zeeg page link description: Teams the user belongs to createdAt: type: string format: date-time description: When the user signed up updatedAt: type: string format: date-time lastLoginAt: type: string format: date-time nullable: true description: >- When the user last logged in to Zeeg (dashboard or SSO). Null if the user has not logged in since this was first tracked. pagination: type: object required: - total - count - totalPages - currentPage properties: total: type: integer minimum: 0 description: Total number of records. count: type: integer minimum: 0 default: 20 description: Number of records per page. totalPages: type: integer minimum: 0 description: Total number of pages. previousPage: type: string nullable: true description: Link to previous page, or null. example: /v2/organizations/users?page=1 currentPage: type: integer minimum: 1 description: Current page number. nextPage: type: string nullable: true description: Link to next page, or null. example: /v2/organizations/users?page=3 examples: Workspace users: value: collection: - uuid: MRJXYG8M66KLBEX isActive: true email: lena.meier@horizondigital.de firstName: Lena lastName: Meier name: Lena Meier slug: lena-meier language: de url: https://zeeg.me/lena-meier avatarUrl: null timezone: Europe/Berlin role: owner teams: - uuid: 73e4761b-5257-4e83-a807-974a3f2f3adc title: Customer Success slug: customer-success url: https://zeeg.me/team/customer-success createdAt: '2026-01-10T09:00:00.000000Z' updatedAt: '2026-04-01T08:15:00.000000Z' lastLoginAt: '2026-05-28T07:42:11.000000Z' - uuid: QK566D4X49E8X78 isActive: true email: marco.rossi@horizondigital.de firstName: Marco lastName: Rossi name: Marco Rossi slug: marco-rossi language: en url: https://zeeg.me/marco-rossi avatarUrl: null timezone: Europe/Rome role: admin teams: - uuid: 73e4761b-5257-4e83-a807-974a3f2f3adc title: Customer Success slug: customer-success url: https://zeeg.me/team/customer-success createdAt: '2026-02-05T11:30:00.000000Z' updatedAt: '2026-04-01T08:15:00.000000Z' lastLoginAt: null pagination: total: 2 count: 20 totalPages: 1 previousPage: null currentPage: 1 nextPage: null '401': $ref: '#/components/responses/401' security: - bearer: [] components: responses: '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: Unauthenticated. examples: Unauthenticated: value: message: Unauthenticated. securitySchemes: bearer: type: http scheme: bearer description: '' ````