--- title: "List organization members" method: GET path: "/v2/organizations/{organization_id}/members" tags: ["members"] --- # List organization members `GET /v2/organizations/{organization_id}/members` ## Request - Base URL: `https://api.hubstaff.com` - URL: `https://api.hubstaff.com/v2/organizations/{organization_id}/members` - Auth: OAuth 2 - Authorization code: `https://account.hubstaff.com/authorizations/new` - Token URL: `https://account.hubstaff.com/access_tokens` scopes: `hubstaff:read`, `hubstaff:write` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns a collection of members for the given organization. Results can be filtered by search, user IDs, membership role, and date range. *trackable* - Whether the user can track time. This is one of 3 values - *false* -- meaning tracking has been explicitly disabled for this user regardless of their role - *true* -- meaning they are allowed to track time - *viewer* -- meaning they are allowed to track time, however as they are only a project viewer (or no memberships) they implicitly can not track on any project *membership_role* - The basic role in this organization - *owner* - An owner of the organization. This member can do anything within the organization. - *manager* - An manager of the organization. This member can do anything within the organization except things to do with money. (payroll, invoicing, account billing) - *user* - (By project). A member of the organization where permissions are defined by their project memberships *effective_role* - represents an effective role that combines a member's organization role and their project roles - *organization_owner* - The member is an organization owner - *organization_manager* - The member is an organization manager - *project_manager* - The member is an organization user and a manager on all projects and teams - *project_user* - The member is an organization user and a user on all projects and teams - *project_viewer* - The member is an organization user and a viewer on all projects and teams - *by_project* - The member is an organization user and has mixed roles on their projects and team memberships (advanced in the web UI) - *unassigned* - The member has no assigned role and no project memberships (No role in the web UI) *profile* - The profile information for the user. Only organization owners and managers may see this information. - *custom_fields* - The custom fields, defined for organization, in format of "key": "value". The meaning of keys is defined in organization.member_profile_fields. **Filtering by dates:** You can filter members by when they were added to the organization using the `created_at` parameter: - Use `created_at[start]` to get members added on or after a specific date - Use `created_at[stop]` to get members added before a specific date - Use both to get members added within a date range You can also filter by when membership was last updated using the `updated_at` parameter: - Use `updated_at[start]` to get members updated on or after a specific date - Use `updated_at[stop]` to get members updated before a specific date - Use both to get members updated within a date range ## Path parameters - `organization_id` integer, required ## Query parameters - `page_start_id` integer - `page_limit` integer - `search[email]` string - `search[name]` string - `include_removed` boolean - `include_profile` boolean - `include_projects` boolean - `project_statuses` string[] - `include_limits` boolean - `membership_roles` string[] - `invite_link_id` integer - `created_at[start]` string, date-time - `created_at[stop]` string, date-time - `updated_at[start]` string, date-time - `updated_at[stop]` string, date-time - `user_ids` integer[] - `include` string[] ## Response `200` A list of members - object - `members` OrganizationMember[] - `user_id` integer, required: User ID - `pay_rate` string: Pay rate - `bill_rate` string: Bill rate - `currency` string: Currency of pay and bill rates - `membership_role` string, required: Membership role - `membership_status` string, required: Membership status - `created_at` string, date-time, required: When the member was added to the organization/project - `updated_at` string, date-time, required: When the membership was last updated - `removed_at` string, date-time: When the member was removed - `last_client_activity` string, date-time, required: Last client activity of user - `user` User: User model - `id` integer, required: User ID - `name` string, required: User full name - `first_name` string, required: User first name - `last_name` string, required: User last name - `email` string: User email address - `time_zone` string, required: User time zone - `ip_address` string, required: User last IP address - `status` string, required: User status - `created_at` string, date-time, required: When the record was created - `updated_at` string, date-time, required: When the record was last updated - `project_members` NestedProjectMember[]: List of project memberships - `pay_rate` string: Pay rate - `bill_rate` string: Bill rate - `currency` string: Currency of pay and bill rates - `membership_role` string, required: Membership role - `membership_status` string, required: Membership status - `created_at` string, date-time, required: When the member was added to the organization/project - `updated_at` string, date-time, required: When the membership was last updated - `removed_at` string, date-time: When the member was removed - `last_client_activity` string, date-time, required: Last client activity of user - `team_id` integer: Team ID - `profile` OrganizationMemberProfile - `job_title` string: The job title of the member - `job_type` string: The job type of the member - `location` string: The location of the member - `employee_id` string: The employee id of the member - `tax_info` string: The tax info of the member - `birthday` string, date: The member's birthday (YYYY-MM-DD). If the year is not available, it will be 0000 - `started_on` string, date: The start date of the member - `custom_fields` object: Custom fields - `work_phone` string: The work phone number of the member - `personal_phone` string: The personal phone number of the member - `personal_email` string: The personal email address of the member - `department` string: The department of the member - `tax_type` string: The tax type of the member - `occupied_seat` boolean: Whether the member occupies a billing seat - `os_username` string: The OS username of the member - `employment_type` string: The employment type of the member - `work_mode` string: The workplace mode of the member - `in_office_percent` integer: The in-office work percentage of the member - `remote_percent` integer: The remote work percentage of the member - `employed_through` string: How the member is employed - `eor_name` string: The EOR or vendor name of the member - `account_code` string: The account code of the member - `employment_comments` string: Employment comments for the member - `contractual_end_date` string, date: The contractual end date of the member - `termination_reason` string: The termination reason of the member - `home_address` string: The home address of the member - `home_address_country` string: The home address country of the member - `home_address_state` string: The home address state of the member - `work_address` string: The work address of the member - `work_address_country` string: The work address country of the member - `work_address_state` string: The work address state of the member - `project_id` integer, required: Project ID - `project_type` string, required: Project type (project, work_order, work_break) - `project_status` string, required: Project status (active, archived, deleted) - `pay_period` string: Pay period - `fixed_pay_rate` string: Fixed pay rate - `period_week_day` integer: Pay period week day (0 monday) - `period_start_day` integer: Pay period start day - `period_second_start_day` integer: Second pay period start day - `period_anchor_date` string, date: Date when the biweekly pay period must start - `trackable` string, required: Whether the member has tracking enabled, disabled or implicitly disabled - `effective_role` string, required: A virtual membership role that takes into account the project memberships - `profile` OrganizationMemberProfile - `job_title` string: The job title of the member - `job_type` string: The job type of the member - `location` string: The location of the member - `employee_id` string: The employee id of the member - `tax_info` string: The tax info of the member - `birthday` string, date: The member's birthday (YYYY-MM-DD). If the year is not available, it will be 0000 - `started_on` string, date: The start date of the member - `custom_fields` object: Custom fields - `work_phone` string: The work phone number of the member - `personal_phone` string: The personal phone number of the member - `personal_email` string: The personal email address of the member - `department` string: The department of the member - `tax_type` string: The tax type of the member - `occupied_seat` boolean: Whether the member occupies a billing seat - `os_username` string: The OS username of the member - `employment_type` string: The employment type of the member - `work_mode` string: The workplace mode of the member - `in_office_percent` integer: The in-office work percentage of the member - `remote_percent` integer: The remote work percentage of the member - `employed_through` string: How the member is employed - `eor_name` string: The EOR or vendor name of the member - `account_code` string: The account code of the member - `employment_comments` string: Employment comments for the member - `contractual_end_date` string, date: The contractual end date of the member - `termination_reason` string: The termination reason of the member - `home_address` string: The home address of the member - `home_address_country` string: The home address country of the member - `home_address_state` string: The home address state of the member - `work_address` string: The work address of the member - `work_address_country` string: The work address country of the member - `work_address_state` string: The work address state of the member - `limits` OrganizationMemberLimits - `limits_by_shifts` boolean: Whether the shifts are used to set allowance limits - `weekly_limit` number, float: The hours member is allowed to work weekly - `daily_limit` number, float: The hours daily limit of the member - `dow_limit` string[]: The days when member is allowed to track time - `expected_per_week` number, float: The hours member is expected to work weekly - `dow_expected` string[]: The days when member is expected to track time - `type` string, required: How the member was provisioned: standard, scim, silent or sso - `metadata` object, required: Metadata attached to the member - `view_only` boolean, required: View-only member flag ## Other responses - `400`: Invalid parameters - `401`: Unauthorized - `403`: API access is only for organizations on an active plan - `404`: Could not find record - `429`: Rate limit exceeded ## Changes - **2026-11-06** `c6b90e4e4bdc`: 15 info - api tag `members` added - api tag `organizations` removed - added the new optional `query` request parameter `created_at[start]` - added the new optional `query` request parameter `created_at[stop]` - …11 more [Operation history](https://skmtc.dev/hubstaff/apis/hubstaff-v2-api/changes/v2/organizations/:organization_id/members/get.md) --- [API](https://skmtc.dev/hubstaff/apis/hubstaff-v2-api.md) - [All operations](https://skmtc.dev/hubstaff/apis/hubstaff-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hubstaff/apis/hubstaff-v2-api/revisions/c6b90e4e4bdc?raw)