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

# Rechercher des autorisations client

> Rechercher des autorisations client à l’aide de la syntaxe de filtrage SCIM ou Lucene pour obtenir des résultats à faible latence et à cohérence à terme. Utilisez le paramètre parser pour préciser la syntaxe "scim" ou "lucene" (par défaut : "lucene"). Ce terminal offre une solution de rechange au terminal standard GET /client-grants et de meilleures performances pour les requêtes complexes.
Les résultats peuvent ne pas refléter immédiatement les mises à jour récentes.


#### Portées

Les portées définissent les autorisations et les niveaux d’accès des requêtes API et des jetons d’authentification.

[​](#scopes-scopes)


## OpenAPI

````yaml docs/fr-ca/oas/management/v2/management-api-oas.json GET /client-grants/search
openapi: 3.1.0
info:
  title: Auth0 Management API
  description: Auth0 Management API v2.
  termsOfService: https://auth0.com/web-terms/
  contact:
    name: Auth0 Support
    url: https://support.auth0.com
  version: '2.0'
servers:
  - url: https://{tenantDomain}/api/v2
    variables:
      tenantDomain:
        default: '{TENANT}.auth0.com'
        description: Domaine du tenant Auth0
security:
  - bearerAuth: []
externalDocs:
  description: Documentation de l’Auth0 Management API
  url: https://auth0.com/docs/api/management/v2/
paths:
  /client-grants/search:
    get:
      tags:
        - client-grants
      summary: Rechercher des autorisations client
      description: "Rechercher des autorisations client à l’aide de la syntaxe de filtrage SCIM ou Lucene pour obtenir des résultats à faible latence et à cohérence à terme. Utilisez le paramètre parser pour préciser la syntaxe \"scim\" ou \"lucene\" (par défaut\_: \"lucene\"). Ce terminal offre une solution de rechange au terminal standard GET /client-grants et de meilleures performances pour les requêtes complexes.\nLes résultats peuvent ne pas refléter immédiatement les mises à jour récentes.\n"
      operationId: get_client-grants_search
      parameters:
        - name: q
          in: query
          description: "Expression de filtrage utilisant la syntaxe SCIM ou Lucene (selon le paramètre parser). Exemples SCIM\_: `audience eq \"https://api.example.com\"`, `client_id eq \"cli_abc\"`, `subject_type eq \"client\"`, `allow_any_organization eq true`, `default_for eq \"third_party_clients\"`, `audience co \"example\" and organization_id eq \"org_123\"`. Opérateurs SCIM\_: eq, ne, sw, ew, co, pr, gt, ge, lt, le, and, or. <br /><br /><b>Champs pris en charge</b>\_:<ul><li><i>audience</i> - Filtrer par public (eq, ne, sw, co, ew, pr)</li><li><i>client_id</i> - Filtrer par identifiant du client (eq, ne, sw, pr)</li><li><i>subject_type</i> - Filtrer par type de sujet (eq, ne, sw, pr)</li><li><i>allow_any_organization</i> - Filtrer par allow_any_organization (eq, ne, pr)</li><li><i>organization_id</i> - Filtrer par ID de l’organisation (eq, ne, sw, pr)</li><li><i>updated_at</i> - Filtrer par date de dernière mise à jour (eq, ne, gt, ge, lt, le, pr)</li><li><i>default_for</i> - Filtrer par groupe d’autorisations par défaut (eq, ne, sw, pr)</li></ul>Un maximum de 5 opérations de filtrage est permis par requête. Les résultats présentent une cohérence à terme et peuvent ne pas refléter les mises à jour récentes."
          schema:
            type: string
            maxLength: 1000
        - name: parser
          in: query
          description: >-
            Analyseur de requêtes à utiliser pour l’expression de filtrage.
            Utilisez "scim" pour la syntaxe de filtrage SCIM ou "lucene" pour la
            syntaxe de requête Lucene (par défaut).
          schema:
            $ref: '#/components/schemas/SearchParserEnum'
        - name: fields
          in: query
          description: >-
            Liste des champs à inclure dans la réponse ou à en exclure, séparés
            par des virgules. S’utilise avec le paramètre include_fields pour
            contrôler le mode de projection.
          schema:
            type: string
            maxLength: 1000
        - name: include_fields
          in: query
          description: >-
            Contrôle le mode de projection des champs. Définissez la valeur à
            true pour inclure uniquement les champs indiqués dans le paramètre
            fields, ou à false pour les exclure. La valeur par défaut est true
            si aucune valeur n’est précisée.
          schema:
            type: boolean
        - name: take
          in: query
          description: >-
            Nombre maximal de résultats à retourner par page (1-100). La valeur
            par défaut est 50.
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: from
          in: query
          description: >-
            Curseur pour la page suivante de résultats. Utilisez la valeur du
            champ next de la réponse précédente.
          schema:
            type: string
            maxLength: 1000
        - name: sort
          in: query
          description: >-
            Nom du champ selon lequel trier les résultats par ordre croissant.
            Si aucun champ n’est fourni, l’ordre d’insertion est utilisé (les
            plus anciens en premier).
          schema:
            $ref: '#/components/schemas/ClientGrantSortFieldEnum'
      responses:
        '200':
          description: Autorisations client récupérées avec succès.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchClientGrantsResponseContent'
        '400':
          description: Chaîne de requête non valide. Le message varie selon la cause.
        '401':
          description: Jeton non valide.
          x-description-1: Invalid signature received for JSON Web Token validation.
          x-description-2: Client is not global.
        '403':
          description: "Permission insuffisante; l’une des permissions suivantes est requise\_: read:client_grants."
        '404':
          description: Introuvable
        '429':
          description: >-
            Trop de requêtes. Vérifiez les en-têtes X-RateLimit-Limit,
            X-RateLimit-Remaining et X-RateLimit-Reset.
        '500':
          description: Une erreur interne du serveur s’est produite
        '504':
          description: >-
            Le délai d’attente de la requête de recherche est dépassé. Veuillez
            simplifier votre requête et réessayer.
      security:
        - bearerAuth: []
        - oAuth2ClientCredentials:
            - read:client_grants
      x-codeSamples: []
components:
  schemas:
    SearchParserEnum:
      type: string
      enum:
        - scim
        - lucene
      description: "Analyseur de requêtes à utiliser pour l’expression de filtre. Utilisez «\_scim\_» pour la syntaxe de filtre SCIM ou «\_lucene\_» pour la syntaxe de requête Lucene (par défaut)."
    ClientGrantSortFieldEnum:
      type: string
      enum:
        - audience
        - updated_at
      description: >-
        Nom du champ utilisé pour trier les résultats par ordre croissant. Si
        aucun nom n’est fourni, l’ordre d’insertion est utilisé par défaut (les
        plus anciens en premier).
    SearchClientGrantsResponseContent:
      type: object
      additionalProperties: false
      required:
        - client_grants
      properties:
        client_grants:
          type: array
          description: >-
            Tableau d’objets d’autorisation client correspondant aux critères de
            recherche.
          items:
            $ref: '#/components/schemas/ClientGrantResponseContent'
        next:
          type: string
          description: >-
            Curseur permettant de récupérer la page suivante de résultats. Omis
            s’il n’y a plus de résultats.
    ClientGrantResponseContent:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          description: ID du client grant.
        client_id:
          type: string
          description: ID du client.
        audience:
          type: string
          description: L’audience (identifiant d’API) de ce client grant.
          minLength: 1
        scope:
          type: array
          description: Scopes autorisés pour ce client grant.
          items:
            type: string
            minLength: 1
        organization_usage:
          $ref: '#/components/schemas/ClientGrantOrganizationUsageEnum'
        allow_any_organization:
          type: boolean
          description: >-
            Si cette option est activée, n’importe quelle organisation peut être
            utilisée avec ce grant. Si elle est désactivée (par défaut), le
            grant doit être explicitement attribué aux organisations souhaitées.
        default_for:
          $ref: '#/components/schemas/ClientGrantDefaultForEnum'
          x-release-lifecycle: GA
        is_system:
          type: boolean
          description: >-
            Si cette option est activée, ce grant est un grant spécial créé par
            Auth0. Il ne peut pas être modifié ni supprimé directement.
        subject_type:
          $ref: '#/components/schemas/ClientGrantSubjectTypeEnum'
        authorization_details_types:
          type: array
          description: Types de authorization_details autorisés pour ce client grant.
          items:
            type: string
            minLength: 1
            maxLength: 255
        allow_all_scopes:
          type: boolean
          description: >-
            Si cette option est activée, tous les scopes configurés sur le
            resource server sont autorisés pour ce grant.
    ClientGrantOrganizationUsageEnum:
      type: string
      description: >-
        Définit si les organizations peuvent être utilisées avec les échanges
        client credentials pour ce grant.
      enum:
        - deny
        - allow
        - require
    ClientGrantDefaultForEnum:
      type: string
      enum:
        - third_party_clients
      x-release-lifecycle: GA
      description: >-
        Applique ce client grant par défaut à tous les clients du groupe
        indiqué. La seule valeur acceptée est <a
        href="https://auth0.com/docs/get-started/applications/application-access-to-apis-client-grants#default-permissions-for-third-party-applications">`third_party_clients`</a>,
        qui applique le grant à tous les clients tiers. Les client grants par
        client pour la même audience ont préséance. S’exclut mutuellement avec
        `client_id`.
    ClientGrantSubjectTypeEnum:
      type: string
      enum:
        - client
        - user
        - anonymous_user
      description: Le type d’accès à l’application permis par ce client grant.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: jwt
    oAuth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /oauth/token/
          x-form-parameters:
            audience: /api/v2/
          scopes:
            create:actions: Create Actions
            read:actions: Read Actions
            update:actions: Update Actions
            delete:actions: Delete Actions
            create:agents: Create Agents
            read:agents: Read Agents
            update:agents: Update Agents
            delete:agents: Delete Agents
            read:anomaly_blocks: Read Anomaly Blocks
            delete:anomaly_blocks: Delete Anomaly Blocks
            read:attack_protection: Read Attack Protection
            update:attack_protection: Update Attack Protection
            create:authentication_methods: Create Authentication Methods
            read:authentication_methods: Read Authentication Methods
            update:authentication_methods: Update Authentication Methods
            delete:authentication_methods: Delete Authentication Methods
            read:branding: Read Branding
            update:branding: Update Branding
            delete:branding: Delete Branding
            create:client_credentials: Create Client Credentials
            read:client_credentials: Read Client Credentials
            update:client_credentials: Update Client Credentials
            delete:client_credentials: Delete Client Credentials
            create:client_grants: Create Client Grants
            read:client_grants: Read Client Grants
            update:client_grants: Update Client Grants
            delete:client_grants: Delete Client Grants
            read:client_keys: Read Client Keys
            update:client_keys: Update Client Keys
            read:client_summary: Read Client Summary
            update:client_token_vault_privileged_access: Update Client Token Vault Privileged Access
            create:clients: Create Clients
            read:clients: Read Clients
            update:clients: Update Clients
            delete:clients: Delete Clients
            create:connection_profiles: Create Connection Profiles
            read:connection_profiles: Read Connection Profiles
            update:connection_profiles: Update Connection Profiles
            delete:connection_profiles: Delete Connection Profiles
            create:connections: Create Connections
            read:connections: Read Connections
            update:connections: Update Connections
            delete:connections: Delete Connections
            create:connections_keys: Create Connections Keys
            read:connections_keys: Read Connections Keys
            update:connections_keys: Update Connections Keys
            read:current_user: Read Current User
            delete:current_user: Delete Current User
            create:current_user_device_credentials: Create Current User Device Credentials
            delete:current_user_device_credentials: Delete Current User Device Credentials
            update:current_user_identities: Update Current User Identities
            update:current_user_metadata: Update Current User Metadata
            create:custom_domains: Create Custom Domains
            read:custom_domains: Read Custom Domains
            update:custom_domains: Update Custom Domains
            delete:custom_domains: Delete Custom Domains
            create:custom_signing_keys: Create Custom Signing Keys
            read:custom_signing_keys: Read Custom Signing Keys
            update:custom_signing_keys: Update Custom Signing Keys
            delete:custom_signing_keys: Delete Custom Signing Keys
            read:device_credentials: Read Device Credentials
            delete:device_credentials: Delete Device Credentials
            create:directory_provisionings: Create Directory Provisionings
            read:directory_provisionings: Read Directory Provisionings
            update:directory_provisionings: Update Directory Provisionings
            delete:directory_provisionings: Delete Directory Provisionings
            create:email_provider: Create Email Provider
            read:email_provider: Read Email Provider
            update:email_provider: Update Email Provider
            delete:email_provider: Delete Email Provider
            create:email_templates: Create Email Templates
            read:email_templates: Read Email Templates
            update:email_templates: Update Email Templates
            create:encryption_keys: Create Encryption Keys
            read:encryption_keys: Read Encryption Keys
            update:encryption_keys: Update Encryption Keys
            delete:encryption_keys: Delete Encryption Keys
            read:event_deliveries: Read Event Deliveries
            update:event_deliveries: Update Event Deliveries
            create:event_streams: Create Event Streams
            read:event_streams: Read Event Streams
            update:event_streams: Update Event Streams
            delete:event_streams: Delete Event Streams
            read:events: Read Events
            create:experimentation: Create Experimentation
            read:experimentation: Read Experimentation
            update:experimentation: Update Experimentation
            delete:experimentation: Delete Experimentation
            create:flows: Create Flows
            read:flows: Read Flows
            update:flows: Update Flows
            delete:flows: Delete Flows
            read:flows_executions: Read Flows Executions
            delete:flows_executions: Delete Flows Executions
            create:flows_vault_connections: Create Flows Vault Connections
            read:flows_vault_connections: Read Flows Vault Connections
            update:flows_vault_connections: Update Flows Vault Connections
            delete:flows_vault_connections: Delete Flows Vault Connections
            create:forms: Create Forms
            read:forms: Read Forms
            update:forms: Update Forms
            delete:forms: Delete Forms
            read:grants: Read Grants
            delete:grants: Delete Grants
            read:group_members: Read Group Members
            create:group_roles: Create Group Roles
            read:group_roles: Read Group Roles
            delete:group_roles: Delete Group Roles
            read:groups: Read Groups
            delete:groups: Delete Groups
            create:guardian_enrollment_tickets: Create Guardian Enrollment Tickets
            read:guardian_enrollments: Read Guardian Enrollments
            delete:guardian_enrollments: Delete Guardian Enrollments
            read:guardian_factors: Read Guardian Factors
            update:guardian_factors: Update Guardian Factors
            create:hooks: Create Hooks
            read:hooks: Read Hooks
            update:hooks: Update Hooks
            delete:hooks: Delete Hooks
            create:log_streams: Create Log Streams
            read:log_streams: Read Log Streams
            update:log_streams: Update Log Streams
            delete:log_streams: Delete Log Streams
            read:logs: Read Logs
            read:logs_users: Read Logs Users
            read:mfa_policies: Read Mfa Policies
            update:mfa_policies: Update Mfa Policies
            create:network_acls: Create Network Acls
            read:network_acls: Read Network Acls
            update:network_acls: Update Network Acls
            delete:network_acls: Delete Network Acls
            create:organization_client_grants: Create Organization Client Grants
            read:organization_client_grants: Read Organization Client Grants
            delete:organization_client_grants: Delete Organization Client Grants
            create:organization_connections: Create Organization Connections
            read:organization_connections: Read Organization Connections
            update:organization_connections: Update Organization Connections
            delete:organization_connections: Delete Organization Connections
            create:organization_discovery_domains: Create Organization Discovery Domains
            read:organization_discovery_domains: Read Organization Discovery Domains
            update:organization_discovery_domains: Update Organization Discovery Domains
            delete:organization_discovery_domains: Delete Organization Discovery Domains
            create:organization_group_roles: Create Organization Group Roles
            read:organization_group_roles: Read Organization Group Roles
            delete:organization_group_roles: Delete Organization Group Roles
            read:organization_groups: Read Organization Groups
            create:organization_invitations: Create Organization Invitations
            read:organization_invitations: Read Organization Invitations
            delete:organization_invitations: Delete Organization Invitations
            read:organization_member_effective_roles: Read Organization Member Effective Roles
            read:organization_member_role_source_groups: Read Organization Member Role Source Groups
            create:organization_member_roles: Create Organization Member Roles
            read:organization_member_roles: Read Organization Member Roles
            delete:organization_member_roles: Delete Organization Member Roles
            create:organization_members: Create Organization Members
            read:organization_members: Read Organization Members
            delete:organization_members: Delete Organization Members
            create:organizations: Create Organizations
            read:organizations: Read Organizations
            update:organizations: Update Organizations
            delete:organizations: Delete Organizations
            read:organizations_summary: Read Organizations Summary
            create:phone_providers: Create Phone Providers
            read:phone_providers: Read Phone Providers
            update:phone_providers: Update Phone Providers
            delete:phone_providers: Delete Phone Providers
            create:phone_templates: Create Phone Templates
            read:phone_templates: Read Phone Templates
            update:phone_templates: Update Phone Templates
            delete:phone_templates: Delete Phone Templates
            read:prompts: Read Prompts
            update:prompts: Update Prompts
            create:rate_limit_policies: Create Rate Limit Policies
            read:rate_limit_policies: Read Rate Limit Policies
            update:rate_limit_policies: Update Rate Limit Policies
            delete:rate_limit_policies: Delete Rate Limit Policies
            read:refresh_tokens: Read Refresh Tokens
            update:refresh_tokens: Update Refresh Tokens
            delete:refresh_tokens: Delete Refresh Tokens
            create:resource_servers: Create Resource Servers
            read:resource_servers: Read Resource Servers
            update:resource_servers: Update Resource Servers
            delete:resource_servers: Delete Resource Servers
            create:role_members: Create Role Members
            read:role_members: Read Role Members
            delete:role_members: Delete Role Members
            create:roles: Create Roles
            read:roles: Read Roles
            update:roles: Update Roles
            delete:roles: Delete Roles
            create:rules: Create Rules
            read:rules: Read Rules
            update:rules: Update Rules
            delete:rules: Delete Rules
            read:rules_configs: Read Rules Configs
            update:rules_configs: Update Rules Configs
            delete:rules_configs: Delete Rules Configs
            create:scim_config: Create Scim Config
            read:scim_config: Read Scim Config
            update:scim_config: Update Scim Config
            delete:scim_config: Delete Scim Config
            create:scim_token: Create Scim Token
            read:scim_token: Read Scim Token
            delete:scim_token: Delete Scim Token
            read:self_service_profile_custom_texts: Read Self Service Profile Custom Texts
            update:self_service_profile_custom_texts: Update Self Service Profile Custom Texts
            create:self_service_profiles: Create Self Service Profiles
            read:self_service_profiles: Read Self Service Profiles
            update:self_service_profiles: Update Self Service Profiles
            delete:self_service_profiles: Delete Self Service Profiles
            read:sessions: Read Sessions
            update:sessions: Update Sessions
            delete:sessions: Delete Sessions
            create:signing_keys: Create Signing Keys
            read:signing_keys: Read Signing Keys
            update:signing_keys: Update Signing Keys
            create:sso_access_tickets: Create Sso Access Tickets
            delete:sso_access_tickets: Delete Sso Access Tickets
            read:stats: Read Stats
            read:tenant_settings: Read Tenant Settings
            update:tenant_settings: Update Tenant Settings
            create:token_exchange_profiles: Create Token Exchange Profiles
            read:token_exchange_profiles: Read Token Exchange Profiles
            update:token_exchange_profiles: Update Token Exchange Profiles
            delete:token_exchange_profiles: Delete Token Exchange Profiles
            create:user_attribute_profiles: Create User Attribute Profiles
            read:user_attribute_profiles: Read User Attribute Profiles
            update:user_attribute_profiles: Update User Attribute Profiles
            delete:user_attribute_profiles: Delete User Attribute Profiles
            read:user_effective_permissions: Read User Effective Permissions
            read:user_effective_roles: Read User Effective Roles
            read:user_idp_tokens: Read User Idp Tokens
            read:user_permission_source_roles: Read User Permission Source Roles
            read:user_role_source_groups: Read User Role Source Groups
            create:user_tickets: Create User Tickets
            create:users: Create Users
            read:users: Read Users
            update:users: Update Users
            delete:users: Delete Users
            update:users_app_metadata: Update Users App Metadata
            create:vdcs_templates: Create Vdcs Templates
            read:vdcs_templates: Read Vdcs Templates
            update:vdcs_templates: Update Vdcs Templates
            delete:vdcs_templates: Delete Vdcs Templates
            create:client_profiles: Create Client Profiles
            read:client_profiles: Read Client Profiles
            update:client_profiles: Update Client Profiles
            delete:client_profiles: Delete Client Profiles
            create:organization_clients: Create Organization Client Associations
            read:organization_clients: Read Organization Client Associations
            update:organization_clients: Update Organization Client Associations
            delete:organization_clients: Delete Organization Client Associations
            create:network_acl_keys: Create Network ACL Keys
            read:network_acl_keys: Read Network ACL Keys
            delete:network_acl_keys: Delete Network ACL Keys

````