> ## Documentation Index > Fetch the complete documentation index at: https://docs.stardex.com/llms.txt > Use this file to discover all available pages before exploring further. # List team members > Retrieve a paginated list of team members (recruiters and staff). Supports filtering by active status, first name, last name, and email address. **When to use**: Call this to discover team member IDs needed for filtering in search endpoints — e.g. `person_owner_ids_included`, `candidate_owner_ids_included`, `sourced_by_ids`, or `team_member_attribute_filters` in `POST /v1/persons/search`. ## OpenAPI ````yaml /api-reference/openapi-v1.json get /v1/team-members openapi: 3.1.0 info: title: Stardex API (v1) version: 1.0.0 description: >- Stardex ATS API — manage candidates, jobs, companies, and recruiting workflows. servers: - url: https://api.stardex.ai description: Production API server security: - bearerAuth: [] tags: - name: Persons description: Manage person records — contacts, work history, and custom fields. - name: Jobs description: Manage job postings — pipeline stages, team members, and custom fields. - name: Candidates description: Manage candidate records and pipeline stage transitions. - name: Companies description: Browse and retrieve company records. - name: Lists description: Create, search, and retrieve saved person and company lists. - name: Person Activities description: Create and manage activity records (notes, emails, meetings) for persons. - name: Team Members description: List team members for use in search filters and assignments. - name: Custom Fields description: Retrieve custom field definitions and tag options for search filters. paths: /v1/team-members: get: tags: - Team Members summary: List team members description: >- Retrieve a paginated list of team members (recruiters and staff). Supports filtering by active status, first name, last name, and email address. **When to use**: Call this to discover team member IDs needed for filtering in search endpoints — e.g. `person_owner_ids_included`, `candidate_owner_ids_included`, `sourced_by_ids`, or `team_member_attribute_filters` in `POST /v1/persons/search`. operationId: listTeamMembers parameters: - schema: type: - integer - 'null' minimum: 0 default: 0 description: Records to skip for pagination. Defaults to 0. required: false name: offset in: query - schema: type: integer minimum: 1 maximum: 100 default: 100 description: Max records per page (1–100). Defaults to 100. required: false name: limit in: query - schema: type: boolean description: >- Filter by active status. true = active only, false = inactive only, omit = all. required: false name: is_active in: query - schema: type: string description: Filter by first name (case-insensitive partial match). required: false name: first_name in: query - schema: type: string description: Filter by last name (case-insensitive partial match). required: false name: last_name in: query - schema: type: string description: >- Filter by email address (case-insensitive exact match against the team member's auth user email). required: false name: email_address in: query responses: '200': description: Team members fetched content: application/json: schema: $ref: '#/components/schemas/TeamMembersListResponse' example: success: true data: - id: 123e4567-e89b-12d3-a456-426614174000 first_name: Jane last_name: Smith email: jane@company.com image_url: null is_active: true meta: total: 8 offset: 0 limit: 100 '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '404': description: Resource not found content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error components: schemas: TeamMembersListResponse: type: object properties: success: type: boolean enum: - true data: type: array items: $ref: '#/components/schemas/TeamMember' meta: type: object properties: total: type: number description: Total matching records across all pages. offset: type: number description: Current pagination offset. limit: type: number description: Page size used for this request. required: - total - offset - limit required: - success - data - meta TeamMember: type: object properties: id: type: string description: >- Team member UUID. Use this ID in person_owner_ids, candidate_owner_ids, sourced_by_ids, and team_member_attribute_filters across search endpoints. first_name: type: - string - 'null' description: First name. last_name: type: - string - 'null' description: Last name. email: type: - string - 'null' description: Email address (from authentication provider). image_url: type: - string - 'null' description: Profile image URL. is_active: type: boolean description: True if the team member is currently active and can log in. required: - id - first_name - last_name - email - image_url - is_active securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Authenticate with a Bearer token: API key, OAuth token, or session token. ````