> ## Documentation Index
> Fetch the complete documentation index at: https://developers.everhour.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Users

> List all members of the team, including removed ones. Each member comes back with profile, group, permission, and time tracking policy fields. What you see depends on your own access: `cost` returns `0` unless you have the `costs` permission, and `permissions` returns an empty array (`[]`) for members with no elevated access.

Supports `query` for name search and `limit` for pagination — see [Pagination](/pagination).



## OpenAPI

````yaml /openapi.json get /team/users
openapi: 3.1.1
info:
  title: Everhour API
  version: 1.0.0
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
  - url: https://api.everhour.com
security:
  - ApiKeyAuth: []
tags:
  - name: Clients
  - name: Custom Fields
  - name: Expenses
  - name: Invoices
  - name: Projects
  - name: Reports
  - name: Schedule
  - name: Tasks
  - name: Time Off
  - name: Time Records
  - name: Timecards
  - name: Timers
  - name: Timesheets
  - name: Users
  - name: Webhooks
paths:
  /team/users:
    get:
      tags:
        - Users
      summary: Get All Users
      description: >-
        List all members of the team, including removed ones. Each member comes
        back with profile, group, permission, and time tracking policy fields.
        What you see depends on your own access: `cost` returns `0` unless you
        have the `costs` permission, and `permissions` returns an empty array
        (`[]`) for members with no elevated access.


        Supports `query` for name search and `limit` for pagination — see
        [Pagination](/pagination).
      operationId: getAllUsers
      parameters:
        - name: query
          in: query
          required: false
          description: Filter users by name or email.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Maximum number of users to return.
          schema:
            type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
        '401':
          description: Unauthorized
components:
  schemas:
    User:
      type: object
      description: >-
        A team member. `GET /team/users` and `GET /users/me` return the full
        object; `user` objects nested in other resources may contain a subset of
        these fields.
      properties:
        id:
          type: number
          example: 1304
        email:
          type: string
          example: john.bender@example.com
        name:
          type: string
          example: John Bender
        headline:
          type:
            - string
            - 'null'
          description: Job title. Empty string when not set.
          example: CEO
        phone:
          type: string
          description: Omitted when not set.
          example: +1 555 0100
        externalId:
          type: string
          description: >-
            Employee ID from your own system, set on the member profile. Omitted
            when not set.
          example: M-3490
        avatarUrl:
          type:
            - string
            - 'null'
          description: Omitted when the member has no avatar.
          example: https://d36887svjhykt4.cloudfront.net/users/1304-15ea197d07ca81.jpg
        avatarUrlLarge:
          type:
            - string
            - 'null'
          description: Omitted when the member has no avatar.
          example: https://d36887svjhykt4.cloudfront.net/users/1304-15ea197d10830c.jpg
        role:
          type: string
          enum:
            - admin
            - supervisor
            - member
            - member_limited
          example: admin
        status:
          type: string
          enum:
            - active
            - invited
            - pending
            - removed
          example: active
        type:
          type: string
          enum:
            - employee
            - contractor
          example: employee
        createdAt:
          type: string
          description: 'Format: Y-m-d H:i:s'
          example: '2016-08-13 15:27:30'
        isEmailVerified:
          type: boolean
          example: true
        capacity:
          type:
            - integer
            - 'null'
          description: Weekly capacity in seconds.
          example: 144000
        cost:
          type: integer
          description: >-
            Hourly cost in cents. Returns `0` when you lack the `costs`
            permission.
          example: 2500
        costHistory:
          type:
            - array
            - 'null'
          description: >-
            Past hourly cost values. `null` when the member has no cost history
            or you lack the `costs` permission.
          example: null
        groups:
          type: array
          description: >-
            Groups the member belongs to. Empty array when the member is in no
            group.
          items:
            $ref: '#/components/schemas/UserGroup'
        permissions:
          $ref: '#/components/schemas/UserPermissions'
        timeTrackingPolicy:
          $ref: '#/components/schemas/TimeTrackingPolicy'
        resourcePlannerAccess:
          $ref: '#/components/schemas/ResourcePlannerAccess'
        favorite:
          type: boolean
          description: Whether you marked this member as a favorite.
          example: false
      required:
        - id
        - email
        - name
        - role
        - status
        - type
        - createdAt
        - isEmailVerified
        - groups
        - permissions
        - timeTrackingPolicy
        - favorite
    UserGroup:
      type: object
      description: A group the user belongs to.
      properties:
        id:
          type: number
          example: 1
        name:
          type: string
          example: Admins
      required:
        - id
        - name
    UserPermissions:
      type: object
      description: >-
        Areas the user can access beyond the base role. A key is present only
        when the user has access to that area. Users with no elevated access
        return an empty array (`[]`) instead of an object — treat both as "no
        permissions".
      properties:
        billingBudgets:
          type: string
          enum:
            - read
            - write
          example: write
        userLimits:
          type: string
          enum:
            - read
            - write
          example: write
        costs:
          type: string
          enum:
            - read
            - write
          example: write
        invoices:
          type: string
          enum:
            - read
            - write
          example: write
        expenses:
          type: string
          enum:
            - read
            - write
          example: write
    TimeTrackingPolicy:
      type: object
      description: >-
        Time tracking rules that apply to the user. Team defaults unless the
        team overrides them for this member.
      properties:
        allowTimeWithoutTask:
          type: boolean
          example: true
        allowManualTimeInput:
          type: boolean
          example: true
        allowFutureTime:
          type: boolean
          example: false
        allowCompletedTaskTime:
          type: boolean
          example: true
        allowTimeWithoutEstimate:
          type: boolean
          example: true
        allowExceedEstimate:
          type: boolean
          example: false
        allowManageEstimates:
          type: boolean
          example: true
        lockTimeAfter:
          type: integer
          description: >-
            Number of `lockTimePeriod` units after which time entries lock.
            Present only when the team locks time for this member.
          example: 2
        lockTimePeriod:
          type: string
          description: >-
            Unit used by `lockTimeAfter`. Present only when the team locks time
            for this member.
          example: days
    ResourcePlannerAccess:
      type: object
      description: Resource planner access flags. Returned for the authenticated user.
      properties:
        viewMine:
          type: boolean
          example: false
        editMine:
          type: boolean
          example: false
        viewAll:
          type: boolean
          example: false
        editAll:
          type: boolean
          example: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.