---
title: "Team Members"
method: GET
path: "/v1.0/members"
tags: ["Members"]
---

# Team Members

`GET /v1.0/members`

Returns members of the caller's team, optionally filtered by office / group IDs, with pagination metadata.

Notes:
- limit must not exceed the configured maximum; oversized values return 400 LIMIT_PARAM_OVERSIZE.
- offset < 0 is silently reset to 0.
- total in _metadata reflects the full result size before pagination.
- When groupIds is omitted, all members visible to the caller are returned.

## Query parameters

- `groupIds` integer[]
- `offset` integer
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

Page of team members with pagination metadata.

- MemberListResponse — Response for GET /v1.0/members: a page of team members with pagination metadata.
  - `get_metadata` MetaData — Pagination metadata (offset, limit, total, collection).
    - `collection` string — The element of the array
    - `limit` integer — Quantitative limitation of responded elements
    - `offset` integer — Start index of the responded elements
    - `total` integer — The sum of retrieved elements
    - `scrollId` string — Scroll ID for the search. You can then use the scroll ID to retrieve the next batch of results for the request.
  - `members` UserResponse[] — Team members on this page.
    - `id` integer — Team-member record ID.
    - `teamId` integer — ID of the team this member belongs to.
    - `invitorUserId` integer — User ID of the member who invited this member.
    - `memberUserId` integer — User ID of the team member.
    - `role` integer — Numeric role code.
    - `roleName` string — Human-readable role name.
    - `firstLetter` string — First letter of the member's name, used for alphabetic grouping.
    - `email` string — Email address of the member.
    - `firstName` string — Given name of the member.
    - `lastName` string — Family name of the member.
    - `phoneNumber` string — Phone number of the member.
    - `status` integer — Numeric status code of the member.
    - `virtualNumber` string — Virtual number assigned to the member for dialer features. Empty string when no virtual number is assigned.
    - `newLeadCount` integer — Number of new (unassigned) leads routable to this member.
    - `assignedLeadCount` integer — Number of leads currently assigned to this member.
    - `isAdmin` boolean — Whether the member is an administrator of the team.
    - `agentInfo` AgentInfo — Additional agent profile details.
      - `licenseId` string — Agent license Id
      - `position` string — Agent position
      - `companyName` string — Agent Company Name
      - `companyAddress` string — Agent company Address
      - `mlsAgentId` string — MLS Agent Id
      - `agentPid` string — Agent Pid
    - `timeZoneId` string — IANA time zone identifier for the member.
    - `groupId` integer — ID of the office / group this member belongs to.
    - `groupName` string — Name of the office / group this member belongs to.
    - `group` OfficeBo
      - `id` integer
      - `teamId` integer
      - `parentId` integer
      - `websiteOwnerId` integer
      - `name` string
      - `type` integer
      - `phone` string
      - `phoneCode` string
      - `phoneCountry` string
      - `email` string
      - `city` string
      - `state` string
      - `zipcode` string
      - `streetAddress` string
      - `webSiteUrl` string
      - `createTime` string, date-time
      - `updateTime` string, date-time
      - `path` string
      - `showInSite` boolean
      - `defaultFlag` boolean
      - `allowManageSub` boolean
      - `agentCount` integer
      - `boundNumber` string
      - `status` 'ACTIVE' | 'PENDING' | 'INACTIVE'
      - `layer` integer
      - `childPath` string
    - `accountStatus` string

## Other responses

- `400` — limit exceeds the configured maximum (LIMIT_PARAM_OVERSIZE).
- `401` — Missing or invalid authentication token.
- `404` — Team has no members matching the filter (20003 USER_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)