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

# Lister les vérifications

> Rend les résultats de vérification de votre entreprise, du plus récent au plus ancien. Les images et les données extraites du document ne sont jamais exposées.



## OpenAPI

````yaml /openapi.json get /api/v1/consultations
openapi: 3.1.0
info:
  title: API Resocom
  version: 1.0.0
  description: >-
    Créer des vérifications d'identité, analyser directement les documents que
    vous détenez déjà, et relire les résultats depuis votre système
    d'information.
servers:
  - url: https://pro.resocom.com
security:
  - cleApi: []
paths:
  /api/v1/consultations:
    get:
      summary: Lister les vérifications
      description: >-
        Rend les résultats de vérification de votre entreprise, du plus récent
        au plus ancien. Les images et les données extraites du document ne sont
        jamais exposées.
      operationId: listerVerifications
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
          description: Taille de page.
        - name: cursor
          in: query
          schema:
            type: string
          description: Curseur de la page suivante (`nextCursor` de la page précédente).
        - name: workflow_id
          in: query
          schema:
            type: string
          description: Restreint à un workflow.
        - name: verdict
          in: query
          schema:
            type: string
            enum:
              - conforme
              - non_conforme
              - suspect
              - analyse_impossible
          description: Filtre par constat technique.
        - name: external_ref
          in: query
          schema:
            type: string
          description: Votre référence de dossier exacte.
        - name: since
          in: query
          schema:
            type: string
            format: date-time
          description: Résultats créés après cette date.
      responses:
        '200':
          description: Page de résultats.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Consultation'
                  nextCursor:
                    type:
                      - string
                      - 'null'
                    description: Curseur de la page suivante — `null` sur la dernière page.
        '401':
          description: Clé absente, inconnue ou révoquée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erreur'
        '403':
          description: La licence de votre entreprise ne couvre pas l'API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erreur'
        '429':
          description: Débit dépassé — respectez l'en-tête `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erreur'
components:
  schemas:
    Consultation:
      type: object
      description: Résultat d'une vérification.
      properties:
        id:
          type: string
          description: Identifiant unique du résultat.
          example: CSL-20260717-3F2A91
        externalRef:
          type:
            - string
            - 'null'
          description: Votre référence de dossier, renvoyée telle quelle.
          example: DOSSIER-88412
        workflowId:
          type:
            - string
            - 'null'
          description: Workflow qui a évalué le document.
          example: WFL-20260706-BEF798
        documentCategory:
          type: string
          enum:
            - identite
            - administratif
          description: Catégorie du document contrôlé.
        documentType:
          type:
            - string
            - 'null'
          description: Type de document détecté.
          example: CNI
        documentCountry:
          type:
            - string
            - 'null'
          description: Pays émetteur (ISO 3166-1 alpha-3).
          example: FRA
        verdict:
          type: string
          enum:
            - conforme
            - non_conforme
            - suspect
            - analyse_impossible
          description: Constat technique de l'analyse — immuable.
        decision:
          type:
            - string
            - 'null'
          enum:
            - conforme
            - a_verifier
            - refuse
            - null
          description: Décision du workflow selon vos règles.
        reviewStatus:
          type:
            - string
            - 'null'
          enum:
            - pending
            - accepted
            - rejected
            - null
          description: Décision de traitement de votre équipe (revue humaine).
        anomalyCount:
          type: integer
          description: Nombre de points d'attention relevés.
        hasRejectAnomaly:
          type: boolean
          description: Au moins un point d'attention bloquant.
        anomalies:
          type: array
          description: Points d'attention relevés par l'analyse.
          items:
            type: object
            properties:
              code:
                type:
                  - string
                  - 'null'
                description: Code machine du point d'attention.
                example: selfie_mismatch
              severity:
                type: string
                enum:
                  - reject
                  - warn
                description: Gravité.
              message:
                type: string
                description: Description lisible.
        twoDDoc:
          type:
            - object
            - 'null'
          description: >-
            Cachet électronique 2D-Doc du document (null si aucun 2D-Doc et rien
            à signaler).
          properties:
            present:
              type: boolean
              description: Un 2D-Doc a été lu sur le document.
            trusted:
              type: boolean
              description: Signature ANTS vérifiée sur le payload principal.
            signatureVerified:
              type: boolean
              description: Signature cryptographique vérifiée.
            signatureStatus:
              type: string
              description: Statut détaillé de la signature (verified, ca_not_found, ...).
            dataMatches:
              type:
                - boolean
                - 'null'
              description: >-
                Concordance entre les données du 2D-Doc et la lecture du
                document (null si non contrôlée).
            readStatus:
              type: string
              enum:
                - read
                - detected_not_read
                - not_detected
              description: >-
                read = lu ; detected_not_read = présent mais qualité d'image
                insuffisante pour le lire (n'est pas une non-conformité) ;
                not_detected = aucun 2D-Doc détecté.
            readStatusMessage:
              type: string
              description: >-
                Libellé du statut de lecture, fourni quand readStatus vaut
                detected_not_read.
              example: '2D-Doc présent mais non lu : qualité d''image insuffisante.'
        analyzedAt:
          type: string
          format: date-time
          description: Date de l'analyse.
        createdAt:
          type: string
          format: date-time
          description: Date d'enregistrement.
    Erreur:
      type: object
      properties:
        error:
          type: string
          description: Code d'erreur machine.
          example: invalid_api_key
  securitySchemes:
    cleApi:
      type: http
      scheme: bearer
      bearerFormat: rsk_live_…
      description: >-
        Clé API créée dans Administration → Entreprise → Clés API (licence
        Groupe).

````