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

# API de comptage des gabarits biométriques

> GET /v3/biometric-templates/count/ : compte les gabarits faciaux sans image conservés par votre application, avec les filtres de la liste (Didit).

Renvoie le nombre de gabarits biométriques correspondant aux mêmes filtres que [Lister les gabarits biométriques](https://docs.didit.me/fr/management-api/biometric-templates/list.md). Les gabarits purgés ne sont pas comptés.

```bash theme={null}
curl -X GET "https://verification.didit.me/v3/biometric-templates/count/?status=active" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
{ "count": 128 }
```

Utilisez-le pour afficher le total sur un tableau de bord, ou pour vérifier ce qu'une [purge en masse](https://docs.didit.me/fr/management-api/biometric-templates/batch-purge.md) filtrée avec `delete_all: true` affecterait avant de l'exécuter.


## OpenAPI

````yaml fr/openapi-25.json GET /v3/biometric-templates/count/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/biometric-templates/count/:
    get:
      tags:
        - Biometric Templates
      summary: Compter les gabarits biométriques conservés
      description: "Une application ayant activé cette option conserve un gabarit biométrique facial géré séparément et sans image, ancré à l'Utilisateur lorsqu'une session est supprimée (voir `DELETE /v3/session/{sessionId}/delete/`). Les gabarits sont des données biométriques avec un `expires_at` fini\_; ils ne contiennent jamais d'images, de données de session ou de champs d'identité, et ils sont purgés lors de la suppression de l'Utilisateur, d'un effacement pour des raisons de confidentialité, de leur expiration ou d'une purge explicite. Ces endpoints acceptent uniquement les clés API d'application (`x-api-key`)\_; les tokens d'utilisateur de la Business Console sont rejetés avec `403`.\n\nRenvoie le nombre de gabarits correspondant aux mêmes filtres que l'endpoint de liste. Utilisez-le pour vérifier ce qu'une purge en masse filtrée avec `delete_all: true` affecterait."
      operationId: count_biometric_templates
      parameters:
        - in: query
          name: vendor_data
          required: false
          description: >-
            Correspondance insensible à la casse sur une sous-chaîne du
            `vendor_data` actuel de l'utilisateur propriétaire.
          schema:
            type: string
        - in: query
          name: vendor_user_uuid
          required: false
          description: Correspondance exacte sur l'utilisateur propriétaire.
          schema:
            type: string
            format: uuid
        - in: query
          name: status
          required: false
          description: Statut de cycle de vie. Les modèles purgés ne sont jamais listés.
          schema:
            type: string
            enum:
              - pending
              - active
              - expired
              - held_out_of_use
              - purge_pending
              - purge_failed
        - in: query
          name: source_type
          required: false
          description: Manière dont le modèle a été créé.
          schema:
            type: string
            enum:
              - session_delete
              - automatic_retention
              - backfill
        - in: query
          name: retained_from
          required: false
          description: Modèles conservés à cette date ou après.
          schema:
            type: string
            format: date-time
        - in: query
          name: retained_to
          required: false
          description: >-
            Modèles conservés à cette date ou avant. Ne doit pas être antérieure
            à `retained_from` (`400`).
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: Nombre.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    minimum: 0
              examples:
                Count:
                  value:
                    count: 128
        '400':
          description: >-
            Valeur de filtre non valide, ou `retained_to` antérieur à
            `retained_from`. Erreurs de validation indexées par champ.
          content:
            application/json:
              examples:
                Bad range:
                  value:
                    retained_to:
                      - Must be on or after retained_from.
        '403':
          description: >-
            Token de l'utilisateur de la Console, ou clé API non autorisée. Ces
            endpoints acceptent uniquement les clés API d'application.
          content:
            application/json:
              examples:
                Forbidden:
                  value:
                    detail: You do not have permission to perform this action.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/biometric-templates/count/?status=active'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.biometric_templates.count()
            print(result)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY.
            const didit = new Didit();

            const result = await didit.biometricTemplates.count();
            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.BiometricTemplates.Count(ctx, didit.BiometricTemplatesCountParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

            // Reads DIDIT_API_KEY.
            Didit client = new Didit();

            var result = client.biometricTemplates().count();
            System.out.println(result);
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY.
            $didit = new DiditClient();

            $result = $didit->biometricTemplates->count();
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.biometric_templates.count
            puts result.to_h
        - lang: csharp
          label: .NET
          source: |-
            using System;
            using System.Text.Json;
            using Didit;

            // Reads DIDIT_API_KEY.
            using var client = new DiditClient();

            var result = await client.BiometricTemplates.CountAsync();
            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clé API de votre application, issue de Développeurs -> Clés API dans
        la Business Console. La clé principale dispose d'un accès complet. Une
        clé nommée peut être restreinte : aucun, lecture ou écriture par
        ressource, limitée à certains workflows ou aux sessions approuvées, à
        une liste d'adresses IP et à une date d'expiration. 401 signifie que la
        clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a
        été envoyée, que la clé n'a pas accès à cette ressource ou action, ou
        que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur
        une route de session signifie que la session est hors des workflows ou
        des statuts de la clé. Une clé sans accès aux médias reçoit les URL
        d'images, de vidéos et de PDF à null, et une clé sans accès en écriture
        aux sessions reçoit les liens et tokens de session à null. Voir
        https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.