> ## Documentation Index > Fetch the complete documentation index at: https://docs.forestreet.com/llms.txt > Use this file to discover all available pages before exploring further. # Get team users, advanced > Fetch the users associated with a specific team ## OpenAPI ````yaml get /v2/teams/{teamId}/users openapi: 3.0.0 info: title: Forestreet API version: 1.0.0 description: API documentation for Forestreet API servers: - url: https://rest.forestreet.com description: Forestreet API V2 server security: - apiKeyAuth: [] - bearerAuth: [] - sessionIdQuery: [] tags: [] paths: /v2/teams/{teamId}/users: get: tags: - Teams summary: Get team users, advanced description: Fetch the users associated with a specific team parameters: - schema: type: integer minimum: 0 exclusiveMinimum: true description: ID of the team whose collections are being retrieved. required: true description: ID of the team whose collections are being retrieved. name: teamId in: path - schema: type: number minimum: 1 maximum: 100 default: 10 description: >- Number of items per page, default is 10, minimum is 1, maximum is 100. required: false description: >- Number of items per page, default is 10, minimum is 1, maximum is 100. name: pageSize in: query - schema: type: number minimum: 1 default: 1 description: Current page number, default is 1. required: false description: Current page number, default is 1. name: page in: query requestBody: content: application/json: schema: type: object nullable: true properties: filters: type: object properties: id: type: string description: Filter users by ID. firstName: type: string description: Filter users by first name. lastName: type: string description: Filter users by last name. fullName: type: string description: Filter users by full name. email: type: string description: Filter users by email. additionalProperties: false sortBy: type: array items: type: object properties: field: type: string enum: - firstName - lastName - fullName - email description: Fields to sort team users by. order: type: string enum: - asc - desc description: Sort order according to the specified field. required: - field - order additionalProperties: false default: - field: firstName order: asc description: Sorting criteria for the team users. additionalProperties: false description: >- Request body schema for getting team users, used for filtering and sorting users. responses: '200': description: Get team users response content: application/json: schema: type: object properties: metadata: type: object properties: totalItems: type: number maxUsers: type: number required: - totalItems - maxUsers data: type: array items: type: object properties: id: type: string firstName: type: string lastName: type: string fullName: type: string email: type: string role: type: string enum: - admin - member createdAt: type: string required: - id required: - metadata - data '401': description: Unauthorized - User not authenticated content: application/json: schema: type: object properties: success: type: boolean enum: - false errorCode: type: string enum: - USER_NOT_CONFIRMED - INVALID_CREDENTIALS - INCOMPLETE_CREDENTIALS - INVALID_SESSION_TOKEN - FORCE_CHANGE_PASSWORD - PASSWORD_RESET_REQUIRED - PASSWORD_EXPIRED - CODE_EXPIRED - SESSION_EXPIRED - UNAUTHORISED - AUTHENTICATOR_ERROR - SSO_ACCOUNT - FORBIDDEN - METHOD_NOT_ALLOWED - INVALID_INPUT - PATH_VALIDATION_FAILED - QUERY_VALIDATION_FAILED - BODY_VALIDATION_FAILED - RESPONSE_VALIDATION_FAILED - INVALID_OR_MALFORMED_JSON - INTERNAL_SERVER_ERROR - CONFIGURATION_ERROR - SERVICE_UNAVAILABLE - NOT_FOUND - CONFLICT - LIMIT_EXCEEDED - REVIEW_ALREADY_PENDING - REVIEW_NOT_PENDING - REVIEW_PENDING - REVIEW_INSUFFICIENT_DOMAINS - QUOTA_EXCEEDED - UNSUPPORTED_ENDPOINT_VERSION - ENDPOINT_NOT_FOUND - ENDPOINT_ALREADY_EXISTS message: type: string detail: type: object additionalProperties: nullable: true required: - success - errorCode examples: UNAUTHORISED: value: success: false errorCode: UNAUTHORISED message: Unauthorized - User not authenticated '403': description: Forbidden - You do not have access to this team content: application/json: schema: type: object properties: success: type: boolean enum: - false errorCode: type: string enum: - USER_NOT_CONFIRMED - INVALID_CREDENTIALS - INCOMPLETE_CREDENTIALS - INVALID_SESSION_TOKEN - FORCE_CHANGE_PASSWORD - PASSWORD_RESET_REQUIRED - PASSWORD_EXPIRED - CODE_EXPIRED - SESSION_EXPIRED - UNAUTHORISED - AUTHENTICATOR_ERROR - SSO_ACCOUNT - FORBIDDEN - METHOD_NOT_ALLOWED - INVALID_INPUT - PATH_VALIDATION_FAILED - QUERY_VALIDATION_FAILED - BODY_VALIDATION_FAILED - RESPONSE_VALIDATION_FAILED - INVALID_OR_MALFORMED_JSON - INTERNAL_SERVER_ERROR - CONFIGURATION_ERROR - SERVICE_UNAVAILABLE - NOT_FOUND - CONFLICT - LIMIT_EXCEEDED - REVIEW_ALREADY_PENDING - REVIEW_NOT_PENDING - REVIEW_PENDING - REVIEW_INSUFFICIENT_DOMAINS - QUOTA_EXCEEDED - UNSUPPORTED_ENDPOINT_VERSION - ENDPOINT_NOT_FOUND - ENDPOINT_ALREADY_EXISTS message: type: string detail: type: object additionalProperties: nullable: true required: - success - errorCode examples: FORBIDDEN: value: success: false errorCode: FORBIDDEN message: Forbidden - You do not have access to this team '404': description: Team not found content: application/json: schema: type: object properties: success: type: boolean enum: - false errorCode: type: string enum: - USER_NOT_CONFIRMED - INVALID_CREDENTIALS - INCOMPLETE_CREDENTIALS - INVALID_SESSION_TOKEN - FORCE_CHANGE_PASSWORD - PASSWORD_RESET_REQUIRED - PASSWORD_EXPIRED - CODE_EXPIRED - SESSION_EXPIRED - UNAUTHORISED - AUTHENTICATOR_ERROR - SSO_ACCOUNT - FORBIDDEN - METHOD_NOT_ALLOWED - INVALID_INPUT - PATH_VALIDATION_FAILED - QUERY_VALIDATION_FAILED - BODY_VALIDATION_FAILED - RESPONSE_VALIDATION_FAILED - INVALID_OR_MALFORMED_JSON - INTERNAL_SERVER_ERROR - CONFIGURATION_ERROR - SERVICE_UNAVAILABLE - NOT_FOUND - CONFLICT - LIMIT_EXCEEDED - REVIEW_ALREADY_PENDING - REVIEW_NOT_PENDING - REVIEW_PENDING - REVIEW_INSUFFICIENT_DOMAINS - QUOTA_EXCEEDED - UNSUPPORTED_ENDPOINT_VERSION - ENDPOINT_NOT_FOUND - ENDPOINT_ALREADY_EXISTS message: type: string detail: type: object additionalProperties: nullable: true required: - success - errorCode examples: NOT_FOUND: value: success: false errorCode: NOT_FOUND message: Team not found components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: >- Pass a static API key for every request, provided by your customer support. bearerAuth: type: http scheme: bearer description: >- Bearer token authentication, using a sessionId generated by `GET /v2/auth/session`. sessionIdQuery: type: apiKey in: query name: sessionId description: >- Session ID passed as a query parameter for authentication, provided by `GET /v2/auth/session`. ````