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

# List Team Members

## Overview

Retrieve all team members for a specific tenant (organization). This endpoint returns paginated results with member details including their role and activity status.

## Authorization

* User must be authenticated with a valid Bearer token
* User must be a member of the specified tenant

## Security

Users from different tenants will receive empty results (not a 403 error). This ensures tenant isolation while maintaining a consistent API experience.

## Response Details

The response includes:

* User basic information (id, name, email)
* Role within the tenant (ADMIN or MEMBER)
* Activity status (is\_active)
* Last activity timestamp

## Performance

This endpoint uses an optimized single JOIN query instead of N+1 queries for better performance with large teams.

## Example Usage

```bash theme={null}
curl -X GET \
  https://faisalshop.mvp-apps.ae/api/v2/admin/team-members/1 \
  -H 'Authorization: Bearer YOUR_TOKEN'
```

```javascript theme={null}
const response = await axios.get(
  `/api/v2/admin/team-members/${tenantId}`,
  {
    headers: { Authorization: `Bearer ${token}` }
  }
);
```


## OpenAPI

````yaml GET /api/v2/admin/team-members/{tenantId}
openapi: 3.1.0
info:
  title: Urban Things API
  description: Multi-tenant e-commerce platform API
  version: 2.0.0
  contact:
    email: info@faisalkc.com
servers:
  - url: https://faisalshop.mvp-apps.ae
    description: Production server
  - url: http://localhost:3000
    description: Development server
security:
  - bearerAuth: []
paths:
  /api/v2/admin/team-members/{tenantId}:
    get:
      tags:
        - Team Members
      summary: List team members
      parameters:
        - $ref: '#/components/parameters/TenantIdPath'
      responses:
        '200':
          description: List of team members
          content:
            application/json:
              schema:
                type: object
                properties:
                  team_members:
                    type: object
                    properties:
                      current_page:
                        type: integer
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/TeamMember'
                      per_page:
                        type: integer
                      total:
                        type: integer
components:
  parameters:
    TenantIdPath:
      name: tenantId
      in: path
      required: true
      schema:
        type: integer
      description: Tenant ID
  schemas:
    TeamMember:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        email:
          type: string
          format: email
        role:
          type: string
          enum:
            - ADMIN
            - MEMBER
        is_active:
          type: integer
        last_active_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````