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

# List users

> List the users of the caller's reseller: the users of its clients, plus its own
sellers / reseller-admins.

Filtering follows the standard query filtering rules: `ids`, `client_ids`,
`langs` and `user_types` are repeated flat parameters (OR), e.g.
`ids=1&ids=2`; `email`, `name` and `created_at` require a bracket operator,
e.g. `email[contains]=example.com`. Sorting is `order_by=field.direction`
(e.g. `order_by=created_at.desc`, the default); results are paginated with
`limit`/`offset`.



## OpenAPI

````yaml /api-reference/services_docs_mintlify_enriched/iam_reseller_api.yaml get /iam/resellers/v2/users
openapi: 3.1.0
info:
  title: Gcore OpenAPI – IAM Reseller API
  license:
    name: Proprietary
  description: >-
    This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore
    products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS
    Protection, Object Storage, Streaming, and FastEdge services.
  version: 971cd08a38cb
servers:
  - url: https://api.gcore.com
security:
  - APIKey: []
tags:
  - name: Account
    description: >-
      Account management operations including authentication, password
      management, and account details.
  - name: Clients
    description: >-
      Clients management API.


      Note: For client's creation use [create a new
      user](/api-reference/iam-resellers/users/create-a-new-user) method from
      Users management API.
  - name: Users
    description: Client's users management API.
  - name: Sellers
    description: Seller management API.
  - name: Products' availability
    description: >-
      As a reseller you can get access to multiple products that available for
      you. Such as CDN.


      With this API you can manage which products are available for you clients
      by default or manage personal

      products' availability for each client separately.
  - name: Services
    description: Client services management API for managing service statuses and options.
  - name: Features
    description: You can manage both free and paid features available for you.
  - name: Branding
    description: >-
      Branding settings management API for customizing reseller branding
      including logos, colors, and domain settings.
  - name: Notification Settings
    description: Notification settings which not connected with branding
  - name: Other
paths:
  /iam/resellers/v2/users:
    get:
      tags:
        - Users
      summary: List users
      description: >-
        List the users of the caller's reseller: the users of its clients, plus
        its own

        sellers / reseller-admins.


        Filtering follows the standard query filtering rules: `ids`,
        `client_ids`,

        `langs` and `user_types` are repeated flat parameters (OR), e.g.

        `ids=1&ids=2`; `email`, `name` and `created_at` require a bracket
        operator,

        e.g. `email[contains]=example.com`. Sorting is
        `order_by=field.direction`

        (e.g. `order_by=created_at.desc`, the default); results are paginated
        with

        `limit`/`offset`.
      operationId: iamListResellerUsersV2
      parameters:
        - name: ids
          in: query
          required: false
          style: form
          explode: true
          description: >-
            Filter by user id. Repeat the parameter for several values (OR),
            e.g. `ids=1&ids=2`.
          schema:
            type: array
            items:
              type: integer
        - name: client_ids
          in: query
          required: false
          style: form
          explode: true
          description: >-
            Filter by client id. Repeat the parameter for several values (OR),
            e.g. `client_ids=1&client_ids=2`.
          schema:
            type: array
            items:
              type: integer
        - name: email
          in: query
          required: false
          style: deepObject
          explode: true
          description: >-
            Filter by email, case-insensitive. Bracket operator required:
            `email[exact]`,

            `email[prefix]`, `email[contains]` or `email[suffix]`, e.g.
            `email[contains]=example.com`.
          schema:
            type: object
            additionalProperties: {}
        - name: name
          in: query
          required: false
          style: deepObject
          explode: true
          description: >-
            Filter by name, case-insensitive. Bracket operator required:
            `name[exact]`,

            `name[prefix]`, `name[contains]` or `name[suffix]`, e.g.
            `name[prefix]=Jo`.
          schema:
            type: object
            additionalProperties: {}
        - name: created_at
          in: query
          required: false
          style: deepObject
          explode: true
          description: >-
            Filter by creation time. Bracket operator required:
            `created_at[gte]`,

            `created_at[gt]`, `created_at[lt]` or `created_at[lte]` (ISO 8601),
            e.g.

            `created_at[gte]=2026-01-01T00:00:00Z&created_at[lt]=2026-02-01T00:00:00Z`.
          schema:
            type: object
            additionalProperties: {}
        - name: langs
          in: query
          required: false
          style: form
          explode: true
          description: >-
            Filter by interface language. Repeat the parameter for several
            values (OR), e.g. `langs=en&langs=ru`.
          schema:
            type: array
            items:
              type: string
              enum:
                - az
                - de
                - en
                - ru
                - zh
        - name: user_types
          in: query
          required: false
          style: form
          explode: true
          description: >-
            Filter by user type. Repeat the parameter for several values (OR),
            e.g.

            `user_types=common&user_types=reseller_admin`.
          schema:
            type: array
            items:
              type: string
              enum:
                - common
                - reseller
                - reseller_admin
                - sales
                - system_admin
                - video_platform
        - name: deleted
          in: query
          required: false
          description: Include soft-deleted users. Default false.
          schema:
            type: boolean
        - name: auth_type
          in: query
          required: false
          description: >-
            Filter by login method - a specific social provider, 'sso', or
            'password'.
          schema:
            type: string
            enum:
              - password
              - sso
              - google-oauth2
              - github
        - name: order_by
          in: query
          required: false
          description: >-
            Sort order as `field.direction`, e.g. `order_by=created_at.desc`.
            Allowed

            fields: `created_at`, `email`, `name`, `last_login`. Defaults to
            `created_at.desc`.
          schema:
            type: string
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Offset'
      responses:
        '200':
          description: OK.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResellerUserV2List'
        '401':
          $ref: '#/components/responses/401'
components:
  parameters:
    Limit:
      name: limit
      in: query
      description: The maximum number of items.
      schema:
        type: integer
    Offset:
      name: offset
      in: query
      description: Offset relative to the beginning of list.
      schema:
        type: integer
  schemas:
    PaginatedResellerUserV2List:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          format: uri
          nullable: true
          example: https://api.gcore.com/iam/resellers/v2/users?offset=400&limit=100
        previous:
          type: string
          format: uri
          nullable: true
          example: https://api.gcore.com/iam/resellers/v2/users?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/ResellerUserV2'
    ResellerUserV2:
      type: object
      description: Fixed field set for /resellers/v2/users.
      required:
        - id
        - email
        - name
        - client
        - clients_and_roles
        - created_at
        - deleted
        - groups
        - last_login
        - reseller
        - two_fa
        - user_type
        - auth_types
        - activated
      properties:
        id:
          type: integer
          readOnly: true
        email:
          type: string
          format: email
          maxLength: 255
          description: User's email address used for login and notifications.
        name:
          type: string
          maxLength: 255
          description: Full name of the user.
        client:
          type: integer
          nullable: true
          readOnly: true
        lang:
          $ref: '#/components/schemas/LangEnumV2'
        phone:
          type: string
          maxLength: 255
          nullable: true
          description: User phone
        groups:
          type: array
          readOnly: true
          items:
            $ref: '#/components/schemas/GroupV2'
        activated:
          type: boolean
          readOnly: true
          description: >-
            Whether the user has completed account activation (e.g. accepted
            their invite).
        user_type:
          type: string
          readOnly: true
        two_fa:
          type: boolean
          description: >-
            Indicates whether two-factor authentication (TOTP) is enabled for
            the user.
        auth_types:
          type: array
          readOnly: true
          items:
            type: string
          description: >-
            List of authentication methods available to the user (e.g.,
            'password', 'sso').
        created_at:
          type: string
          format: date-time
          nullable: true
          readOnly: true
        deleted:
          type: boolean
          readOnly: true
          description: Model being deactivated while deleting instead
        last_login:
          type: string
          format: date-time
          nullable: true
          readOnly: true
        reseller:
          type: integer
          nullable: true
          readOnly: true
        clients_and_roles:
          type: array
          readOnly: true
          items:
            $ref: '#/components/schemas/ClientsAndRolesV2'
    LangEnumV2:
      type: string
      enum:
        - az
        - de
        - en
        - ru
        - zh
    GroupV2:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          maxLength: 150
    ClientsAndRolesV2:
      type: object
      required:
        - client_id
        - client_company_name
        - user_roles
        - user_id
        - auth_types
      properties:
        client_id:
          type: integer
          readOnly: true
        client_company_name:
          type: string
          readOnly: true
        user_roles:
          type: array
          readOnly: true
          items:
            type: string
        user_id:
          type: integer
          readOnly: true
        auth_types:
          type: array
          readOnly: true
          items:
            type: string
  responses:
    '401':
      description: >-
        Authentication credentials were not provided or given token not valid
        for any token type.
  securitySchemes:
    APIKey:
      description: >-
        API key for authentication. Make sure to include the word `apikey`,
        followed by a single space and then your token.

        Example: `apikey 1234_abcdef`
      type: apiKey
      in: header
      name: Authorization

````