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

# List User Stores

> Retrieve the user stores for the associated Organization.

#### Scopes

Scopes define permissions and access levels for API requests and authentication tokens.

[​](#scopes-scopes)


## OpenAPI

````yaml docs/oas/myorganization/myorganization-api-oas.json GET /user-stores
openapi: 3.1.0
info:
  title: My Organization API
  description: My Organization API
  termsOfService: https://auth0.com/web-terms/
  version: 1.0.0
  license:
    name: UNLICENSED
    url: https://auth0.com
servers:
  - url: https://{tenantDomain}/my-org/v1
    variables:
      tenantDomain:
        default: '{TENANT}.auth0.com'
        description: Auth0 Tenant Domain
  - url: https://{tenantDomain}/my-org
    variables:
      tenantDomain:
        default: '{TENANT}.auth0.com'
        description: Auth0 Tenant Domain
security: []
tags:
  - name: config
    description: Configuration
    x-displayName: Configuration
  - name: orgManagement
    description: Manage your organization.
    x-displayName: Organization Management
  - name: orgDetails
    description: Manage details related to your organization.
    x-displayName: Organization Details Management
  - name: idpManagement
    description: Manage Identity Providers for your Organization.
    x-displayName: Identity Provider Management
  - name: userStoresManagement
    description: Manage User Stores for your Organization.
    x-displayName: User Stores Management
  - name: orgDomainManagement
    description: Manage domains related to your organization
    x-displayName: Domain Management
  - name: orgMemberManagement
    description: Manage members related to your organization
    x-displayName: Member Management
  - name: clientGrantManagement
    description: Manage client grants for your organization
    x-displayName: Client Grant Management
  - name: clientManagement
    description: Manage API clients for your organization
    x-displayName: Client Management
  - name: roles
    description: Manage roles for your organization
    x-displayName: Roles
  - name: orgGroupManagement
    description: Manage connection groups for your organization
    x-displayName: Group Management
paths:
  /user-stores:
    get:
      tags:
        - userStoresManagement
      summary: List User Stores
      description: Retrieve the user stores for the associated Organization.
      operationId: ListOrganizationUserStores
      parameters:
        - $ref: '#/components/parameters/MemberAccessLevelFilterQueryParameter'
        - $ref: '#/components/parameters/IsEnabledRequestQueryParameter'
      responses:
        '200':
          $ref: '#/components/responses/ListUserStoresResponse'
        '400':
          $ref: '#/components/responses/ClientErrorBadRequestResponse'
        '401':
          $ref: '#/components/responses/ClientErrorUnauthorizedResponse'
        '403':
          $ref: '#/components/responses/ClientErrorInsufficientScopeResponse'
        '404':
          $ref: '#/components/responses/ClientErrorNotFoundOrganizationResponse'
        '429':
          $ref: '#/components/responses/ClientErrorTooManyRequestsResponse'
      security:
        - OAuth2ClientCredentials:
            - read:my_org:user_stores
        - OAuth2AuthCode:
            - read:my_org:user_stores
      x-codeSamples:
        - lang: typescript
          label: List User Stores
          source: |
            import { MyOrganizationClient } from "@auth0/myorganization-js";

            async function main() {
                const client = new MyOrganizationClient({
                    domain: "{YOUR_DOMAIN}",
                    token: "<token>",
                });
                await client.organization.userStores.list({
                    member_access_level: [
                        "none",
                    ],
                    is_enabled: true,
                });
            }
            main();
        - lang: javascript
          label: List User Stores
          source: |
            import { MyOrganizationClient } from "@auth0/myorganization-js";

            async function main() {
                const client = new MyOrganizationClient({
                    domain: "{YOUR_DOMAIN}",
                    token: "<token>",
                });
                await client.organization.userStores.list({
                    member_access_level: [
                        "none",
                    ],
                    is_enabled: true,
                });
            }
            main();
        - lang: go
          label: List User Stores
          source: |
            package example

            import (
                context "context"

                myorganization "github.com/auth0/myorganization-go/v2"
                client "github.com/auth0/myorganization-go/v2/client"
                option "github.com/auth0/myorganization-go/v2/option"
            )

            func do() {
                c, err := client.New(
                    "{YOUR_DOMAIN}",
                    option.WithToken(
                        "<token>",
                    ),
                )
                if err != nil {
                    return
                }
                request := &myorganization.ListOrganizationUserStoresRequestParameters{
                    MemberAccessLevel: []*myorganization.OrganizationAccessLevelEnum{
                        myorganization.OrganizationAccessLevelEnumNone.Ptr(),
                    },
                    IsEnabled: myorganization.Bool(
                        true,
                    ),
                }
                c.Organization.UserStores.List(
                    context.TODO(),
                    request,
                )
            }
        - lang: csharp
          label: List User Stores
          source: |
            using Auth0.MyOrganizationApi;
            using System.Threading.Tasks;
            using Auth0.MyOrganizationApi.Organization;
            using System.Collections.Generic;

            public partial class Examples
            {
                public async Task Example() {
                    var client = new MyOrganizationClient(new MyOrganizationClientOptions
                    {
                        Domain = "{YOUR_DOMAIN}",
                        TokenProvider = new DelegateTokenProvider(_ => Task.FromResult("<token>"))
                    });

                    await client.Organization.UserStores.ListAsync(
                        new ListOrganizationUserStoresRequestParameters {
                            MemberAccessLevel = new List<OrganizationAccessLevelEnum?>(){
                                OrganizationAccessLevelEnum.None,
                            }
                            ,
                            IsEnabled = true
                        }
                    );
                }

            }
        - lang: java
          label: List User Stores
          source: >-
            package com.example.usage;


            import com.auth0.client.myorganization.auth.MyOrganizationClient;

            import
            com.auth0.client.myorganization.organization.types.ListOrganizationUserStoresRequestParameters;

            import
            com.auth0.client.myorganization.types.OrganizationAccessLevelEnum;

            import java.util.Arrays;


            public class Example {
                public static void main(String[] args) {
                    MyOrganizationClient client = MyOrganizationClient
                        .builder()
                        .domain("{YOUR_DOMAIN}")
                        .token("<token>")
                        .build();

                    client.organization().userStores().list(
                        ListOrganizationUserStoresRequestParameters
                            .builder()
                            .isEnabled(true)
                            .memberAccessLevel(
                                Arrays.asList(OrganizationAccessLevelEnum.NONE)
                            )
                            .build()
                    );
                }
            }
        - lang: python
          label: List User Stores
          source: |
            from auth0.myorganization import MyOrganizationClient

            client = MyOrganizationClient(
                domain="{YOUR_DOMAIN}",
                token="<token>",
            )

            client.organization.user_stores.list(
                member_access_level=[
                    "none"
                ],
                is_enabled=True,
            )
components:
  parameters:
    MemberAccessLevelFilterQueryParameter:
      in: query
      name: member_access_level
      required: false
      description: >-
        When present, only connections whose Organization Member Access Level
        matches one of the provided values are returned. Accepted values are
        full, limited, readonly and none.
      schema:
        type: array
        minItems: 1
        items:
          $ref: '#/components/schemas/OrganizationAccessLevelEnum'
    IsEnabledRequestQueryParameter:
      in: query
      name: is_enabled
      required: false
      description: >-
        Filter the returned list by enabled status. When `true`, only enabled
        items are returned; when `false`, only disabled items; when omitted, all
        items are returned.
      schema:
        type: boolean
  responses:
    ListUserStoresResponse:
      description: Retrieve user stores for an Organization.
      headers:
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
        X-Auth0-Error-Kind:
          $ref: '#/components/headers/X-Auth0-Error-Kind'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ListUserStoresResponseContent'
          examples:
            getUserStoresResponseExample:
              $ref: '#/components/examples/ListUserStoresResponseExample'
    ClientErrorBadRequestResponse:
      description: Invalid request body. The message will vary depending on the cause.
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ErrorResponseContent'
              - $ref: '#/components/schemas/ValidationErrorResponseContent'
          examples:
            errorInvalidJsonExample:
              $ref: '#/components/examples/ErrorBadRequestExample'
            validationErrorExample:
              $ref: '#/components/examples/ErrorValidationExample'
    ClientErrorUnauthorizedResponse:
      description: 'Unauthorized: token missing, invalid or expired.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseContent'
          examples:
            errorMissingTokenExample:
              $ref: '#/components/examples/ErrorMissingTokenExample'
    ClientErrorInsufficientScopeResponse:
      description: Insufficient scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseContent'
          examples:
            errorInsufficientScopeExample:
              $ref: '#/components/examples/ErrorInsufficientScopeExample'
    ClientErrorNotFoundOrganizationResponse:
      description: Organization not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseContent'
          examples:
            errorOrgNotFoundExample:
              $ref: '#/components/examples/ErrorOrgNotFoundExample'
    ClientErrorTooManyRequestsResponse:
      description: >-
        Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining
        and X-RateLimit-Reset headers.
      headers:
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
        X-Auth0-Error-Kind:
          $ref: '#/components/headers/X-Auth0-Error-Kind'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseContent'
          examples:
            errorEndpointRateLimitExample:
              $ref: '#/components/examples/ErrorEndpointRateLimitExample'
  schemas:
    OrganizationAccessLevelEnum:
      type: string
      description: The access level allowed for the Organization
      enum:
        - none
        - readonly
        - limited
        - full
    ListUserStoresResponseContent:
      type: object
      additionalProperties: false
      properties:
        user_stores:
          type: array
          items:
            $ref: '#/components/schemas/UserStore'
      required:
        - user_stores
    ErrorResponseContent:
      type: object
      additionalProperties: false
      required:
        - type
        - status
        - title
        - detail
      properties:
        type:
          type: string
          description: A URI that describes the error.
          format: uri
        status:
          type: integer
          description: The HTTP status code result of the request.
        title:
          type: string
          description: A brief description of the error.
        detail:
          type: string
          description: A detailed description of the error.
    ValidationErrorResponseContent:
      type: object
      additionalProperties: false
      required:
        - type
        - status
        - title
        - validation_errors
      properties:
        type:
          type: string
          description: A URI that describes the error.
          format: uri
        status:
          type: integer
          description: The HTTP status code result of the request.
        title:
          type: string
          description: A brief description of the error.
        validation_errors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorDetail'
    UserStore:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          description: User store Id
        name:
          type: string
          description: User store name
        display_name:
          type: string
          description: User store display name
        access_level:
          $ref: '#/components/schemas/OrganizationAccessLevelEnum'
        member_access_level:
          $ref: '#/components/schemas/OrganizationMemberAccessLevelEnum'
          description: >-
            The Organization Member Access Level for this user store: what the
            Organization Admin can do to members authenticated via this
            connection.
          x-release-lifecycle: EA
        is_enabled:
          type: boolean
          description: Is the user store enabled
    ValidationErrorDetail:
      type: object
      additionalProperties: false
      required:
        - detail
      properties:
        detail:
          type: string
          description: A detailed description of the error.
        field:
          type: string
          description: The name of the invalid parameter.
        pointer:
          type: string
          description: >-
            JSON Pointer that points to the exact location of the error in a
            JSON document being validated.
        source:
          type: string
          description: >-
            Specifies the source of the error (e.g., body, query, or header in
            an HTML message).
    OrganizationMemberAccessLevelEnum:
      type: string
      description: >-
        The Organization Member Access Level: what an Organization Administrator
        can do to members authenticated via this connection.
      enum:
        - none
        - readonly
        - limited
        - full
      x-release-lifecycle: EA
  headers:
    X-RateLimit-Limit:
      description: The number of allowed requests in the current rate limit window.
      schema:
        type: integer
    X-RateLimit-Remaining:
      description: The number of remaining requests in the current rate limit window.
      schema:
        type: integer
    X-RateLimit-Reset:
      description: The Unix timestamp indicating when the current rate limit window resets.
      schema:
        type: integer
    Retry-After:
      description: >-
        The number of seconds the client should wait before making a new
        request.
      schema:
        type: integer
    X-Auth0-Error-Kind:
      description: >-
        An indicator that the rate limit exceeded a is global (per tenant)
        limit.
      schema:
        type: string
        enum:
          - global-rate-limit
  examples:
    ListUserStoresResponseExample:
      value:
        user_stores:
          - id: con_abc123
            name: acme-scim
            display_name: Acme SCIM
            access_level: full
            member_access_level: full
    ErrorBadRequestExample:
      value:
        type: https://auth0.com/api-errors#A0E-400-0001
        status: 400
        title: Bad Request
        detail: The request is invalid.
    ErrorValidationExample:
      value:
        type: https://auth0.com/api-errors#A0E-400-0003
        status: 400
        title: Validation Error
        validation_errors:
          - detail: is required
            field: data/property_name
            pointer: /property_name
            source: params
    ErrorMissingTokenExample:
      value:
        type: https://auth0.com/api-errors#A0E-401-0002
        status: 401
        title: Missing Token
        detail: No auth token provided.
    ErrorInsufficientScopeExample:
      value:
        type: https://auth0.com/api-errors#A0E-403-0002
        status: 403
        title: Insufficient Scope
        detail: >-
          The auth token lacks the required scope: Check the API documentation
          for the required scopes for this endpoint.
    ErrorOrgNotFoundExample:
      value:
        type: https://auth0.com/api-errors#A0E-404-0002
        status: 404
        title: Resource Not Found
        detail: The organization does not exist.
    ErrorEndpointRateLimitExample:
      value:
        type: https://auth0.com/api-errors#A0E-429-0003
        status: 429
        title: Endpoint Rate Limit Exceeded
        detail: The endpoint request limit has been exceeded.
  securitySchemes:
    OAuth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          x-form-parameters:
            audience: /myorg-api/v1/
          scopes:
            read:my_org:configuration: Read organization configuration
            read:my_org:details: Read organization details
            update:my_org:details: Update organization details
            read:my_org:identity_providers: Read identity providers for organization
            create:my_org:identity_providers: Create identity provider for organization
            update:my_org:identity_providers: Update identity provider for organization
            delete:my_org:identity_providers: Delete identity provider for organization
            update:my_org:identity_providers_detach: Detach identity provider from organization
            create:my_org:identity_providers_domains: Associate organization domain with identity provider
            delete:my_org:identity_providers_domains: Remove organization domain from identity provider
            create:my_org:domains: Create domain for organization
            read:my_org:domains: Read domains for organization
            update:my_org:domains: Update domain for organization
            delete:my_org:domains: Delete domain for organization
            create:my_org:identity_providers_provisioning: Create provisioning configuration for identity provider
            update:my_org:identity_providers_provisioning: Update provisioning configuration for identity provider
            read:my_org:identity_providers_provisioning: Read provisioning configuration for identity provider
            delete:my_org:identity_providers_provisioning: Delete provisioning configuration for identity provider
            create:my_org:identity_providers_tests: Start identity provider tests for organization
            read:my_org:identity_providers_tests: Read identity provider tests for organization
            create:my_org:identity_providers_scim_tokens: Create a provisioning SCIM token for this identity provider
            read:my_org:identity_providers_scim_tokens: List the provisioning SCIM tokens for this identity provider
            delete:my_org:identity_providers_scim_tokens: Delete a provisioning SCIM configuration for an identity provider
            read:my_org:member_invitations: List member invitations for organization
            create:my_org:member_invitations: Create member invitations for organization
            delete:my_org:member_invitations: Delete member invitations for organization
            read:my_org:members: List members for organization
            delete:my_org:memberships: Delete members from organization without deleting underlying users
            read:my_org:member_roles: List Roles for members in organization
            create:my_org:member_roles: Create Roles for members in organization
            delete:my_org:member_roles: Delete Roles from members for organization
            create:my_org:client_grants: Create client grants for client in organization
            create:my_org:clients: Create API clients for organization
            read:my_org:clients: Read API clients for organization
            delete:my_org:clients: Delete API clients for organization
            read:my_org:user_stores: Read user stores for an organization
            delete:my_org:organizations: Delete this organization
            read:my_org:groups: List connection groups for organization
            read:my_org:group_roles: List roles for a group in organization
            create:my_org:group_roles: Assign roles to a group in organization
            delete:my_org:group_roles: Remove roles from a group in organization
    OAuth2AuthCode:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: /authorize
          tokenUrl: /oauth/token
          x-form-parameters:
            audience: /myorg-api/v1/
          scopes:
            read:my_org:configuration: Read organization configuration
            read:my_org:details: Read organization details
            update:my_org:details: Update organization details
            read:my_org:identity_providers: Read identity providers for organization
            create:my_org:identity_providers: Create identity provider for organization
            update:my_org:identity_providers: Update identity provider for organization
            delete:my_org:identity_providers: Delete identity provider for organization
            update:my_org:identity_providers_detach: Detach identity provider from organization
            create:my_org:identity_providers_domains: Associate organization domain with identity provider
            delete:my_org:identity_providers_domains: Remove organization domain from identity provider
            create:my_org:domains: Create domain for organization
            read:my_org:domains: Read domains for organization
            update:my_org:domains: Update domain for organization
            delete:my_org:domains: Delete domain for organization
            create:my_org:identity_providers_provisioning: Create provisioning configuration for identity provider
            update:my_org:identity_providers_provisioning: Update provisioning configuration for identity provider
            read:my_org:identity_providers_provisioning: Read provisioning configuration for identity provider
            delete:my_org:identity_providers_provisioning: Delete provisioning configuration for identity provider
            create:my_org:identity_providers_tests: Start identity provider tests for organization
            read:my_org:identity_providers_tests: Read identity provider tests for organization
            create:my_org:identity_providers_scim_tokens: Create a provisioning SCIM token for this identity provider
            read:my_org:identity_providers_scim_tokens: List the provisioning SCIM tokens for this identity provider
            delete:my_org:identity_providers_scim_tokens: Delete a provisioning SCIM configuration for an identity provider
            read:my_org:member_invitations: List member invitations for organization
            create:my_org:member_invitations: Create member invitations for organization
            delete:my_org:member_invitations: Delete member invitations for organization
            read:my_org:members: List members for organization
            delete:my_org:memberships: Delete members from organization without deleting underlying users
            read:my_org:member_roles: List Roles for members in organization
            create:my_org:member_roles: Create Roles for members in organization
            delete:my_org:member_roles: Delete Roles from members for organization
            create:my_org:client_grants: Create client grants for client in organization
            create:my_org:clients: Create API clients for organization
            read:my_org:clients: Read API clients for organization
            delete:my_org:clients: Delete API clients for organization
            read:my_org:user_stores: Read user stores for an organization
            delete:my_org:organizations: Delete this organization
            read:my_org:groups: List connection groups for organization
            read:my_org:group_roles: List roles for a group in organization
            create:my_org:group_roles: Assign roles to a group in organization
            delete:my_org:group_roles: Remove roles from a group in organization

````