{
  "openapi": "3.0.3",
  "info": {
    "title": "VerifCV Partner API",
    "version": "1.0.0",
    "description": "API REST pour déposer des dossiers de vérification, consulter leurs résultats et récupérer les documents et rapports. / REST API for submitting verification cases, reading results and retrieving documents and reports."
  },
  "servers": [
    {
      "url": "https://api.verifcv.com",
      "description": "Production"
    },
    {
      "url": "https://api.test.verifcv.com",
      "description": "Sandbox / Test"
    }
  ],
  "security": [
    {
      "partnerOAuth": []
    }
  ],
  "paths": {
    "/oauth/token": {
      "post": {
        "operationId": "token",
        "summary": "Obtain access token",
        "security": [
          {
            "clientBasic": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "grant_type": {
                    "type": "string",
                    "enum": [
                      "client_credentials"
                    ]
                  }
                },
                "required": [
                  "grant_type"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Token"
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "OAuth request error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Invalid client",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            },
            "x-description-fr": "Identifiants API invalides."
          },
          "429": {
            "description": "Rate limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/oauth/revoke": {
      "post": {
        "operationId": "revoke",
        "summary": "Revoke own access token",
        "security": [
          {
            "clientBasic": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "token": {
                    "type": "string"
                  },
                  "token_type_hint": {
                    "type": "string",
                    "enum": [
                      "access_token"
                    ]
                  }
                },
                "required": [
                  "token"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Revoked or unknown token",
            "x-description-fr": "Jeton révoqué ou déjà inconnu. La réponse est vide."
          },
          "400": {
            "description": "OAuth request error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Invalid client",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            },
            "x-description-fr": "Identifiants API invalides."
          },
          "429": {
            "description": "Rate limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/v1/submitters": {
      "get": {
        "operationId": "listSubmitters",
        "summary": "List authorized submitters",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Submitter"
                      },
                      "x-description-fr": "Liste des déposants autorisés.",
                      "description": "List of permitted submitters."
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/v1/profiles": {
      "get": {
        "operationId": "listProfiles",
        "summary": "List permitted profiles",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Profile"
                      },
                      "x-description-fr": "Profils disponibles avec leurs points. Liste vide si le groupe utilise sa configuration de base.",
                      "description": "Available profiles with their checks. Empty when the group uses its base configuration."
                    },
                    "profile_required": {
                      "type": "boolean",
                      "x-description-fr": "Si true, choisissez un profil dans data et envoyez son id dans profile_id à la création.",
                      "description": "If true, choose a profile from data and send its ID as profile_id on creation."
                    },
                    "default_configuration": {
                      "nullable": true,
                      "type": "object",
                      "description": "Group base configuration when no profile exists. Null when profiles are available.",
                      "properties": {
                        "points": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ProfilePoint"
                          },
                          "x-description-fr": "Points de vérification appliqués au dossier, dans l’ordre de l’application client.",
                          "description": "Checks applied to the case, in client application order."
                        },
                        "required_candidate_fields": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "x-description-fr": "Champs candidat obligatoires au dépôt. Une liste vide signifie qu’aucun champ supplémentaire n’est imposé.",
                          "description": "Candidate fields required on submission. An empty list means no additional field is required."
                        }
                      },
                      "required": [
                        "points",
                        "required_candidate_fields"
                      ],
                      "additionalProperties": false,
                      "x-description-fr": "Configuration de base du groupe quand aucun profil n’existe. Vaut null lorsque des profils sont proposés."
                    },
                    "general_documents_allowed": {
                      "type": "boolean",
                      "x-description-fr": "Autorise les documents complémentaires avec kind: general. Ne concerne pas les pièces liées à un point de vérification.",
                      "description": "Allows supplementary documents with kind: general. Does not affect documents attached to a verification point."
                    }
                  },
                  "required": [
                    "data",
                    "general_documents_allowed"
                  ]
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        },
        "description": "Returns all group profiles with their checks and candidate requirements. If no profile exists, returns the group configuration in default_configuration. The individual profile endpoint is optional."
      }
    },
    "/v1/profiles/{profile_id}": {
      "get": {
        "operationId": "getProfile",
        "summary": "Read an authorized profile",
        "parameters": [
          {
            "name": "profile_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Profile"
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/v1/cases": {
      "post": {
        "operationId": "createCase",
        "summary": "Create a case",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:-]+$"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreatedCase"
                }
              }
            },
            "x-description-fr": "Création réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "metadata",
                  "primary_document"
                ],
                "properties": {
                  "metadata": {
                    "$ref": "#/components/schemas/CreateCase"
                  },
                  "primary_document": {
                    "type": "string",
                    "format": "binary"
                  }
                },
                "additionalProperties": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "encoding": {
                "metadata": {
                  "contentType": "application/json"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCases",
        "summary": "List accessible cases",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000,
              "default": 0
            }
          },
          {
            "name": "updated_since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "description": "Inclusive Unix timestamp in seconds, not milliseconds."
            },
            "description": "Select cases changed on or after this Unix UTC timestamp. Use for a new synchronization without snapshot. Omit when paging through an existing snapshot.",
            "x-description-fr": "Sélectionne les dossiers modifiés depuis cette date incluse, en secondes Unix UTC. À utiliser pour une nouvelle synchronisation sans snapshot. À omettre pour parcourir un snapshot existant."
          },
          {
            "name": "snapshot",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "description": "Reuse pagination.snapshot to page through the initial selection for 30 minutes. updated_since need not be repeated. If provided, it must match the original filter.",
            "x-description-fr": "Réutilisez pagination.snapshot pour parcourir la sélection initiale pendant 30 minutes. Inutile de répéter updated_since. Si vous le fournissez, sa valeur doit être identique au filtre initial."
          },
          {
            "name": "Accept-Language",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fr",
                "en"
              ],
              "default": "fr"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseList"
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/v1/cases/{reference}": {
      "get": {
        "operationId": "getCase",
        "summary": "Read all client-visible case results",
        "parameters": [
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 50
            }
          },
          {
            "name": "Accept-Language",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fr",
                "en"
              ],
              "default": "fr"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Case"
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/v1/cases/{reference}/history": {
      "get": {
        "operationId": "getHistory",
        "summary": "Read client-visible history",
        "parameters": [
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 50
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000,
              "default": 0
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 253402300799
            },
            "description": "Events occurring on or after this date, in Unix UTC seconds. Without this filter, the full visible history is available through pagination.",
            "x-description-fr": "Événements survenus à partir de cette date, incluse, en secondes Unix UTC. Sans ce filtre, tout l’historique visible est accessible par pagination."
          },
          {
            "name": "Accept-Language",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fr",
                "en"
              ],
              "default": "fr"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HistoryList"
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/v1/cases/{reference}/report": {
      "get": {
        "operationId": "getReport",
        "summary": "Download an available interim or final report",
        "parameters": [
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 50
            }
          },
          {
            "name": "Accept-Language",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fr",
                "en"
              ],
              "default": "fr"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "description": "Defaults to final. Use interim to request the provisional report. No automatic fallback to another report.",
            "schema": {
              "type": "string",
              "enum": [
                "final",
                "interim"
              ],
              "default": "final"
            },
            "x-description-fr": "final par défaut. Utilisez interim pour demander le rapport provisoire. Aucun remplacement automatique par un autre rapport."
          }
        ],
        "responses": {
          "200": {
            "description": "Authenticated download. never a public storage URL.",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "x-description-fr": "Le fichier est renvoyé après vérification des droits."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/v1/cases/{reference}/documents": {
      "get": {
        "operationId": "listDocuments",
        "summary": "List accessible documents",
        "parameters": [
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 50
            }
          },
          {
            "name": "Accept-Language",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fr",
                "en"
              ],
              "default": "fr"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Document"
                      },
                      "x-description-fr": "Liste des documents accessibles du dossier.",
                      "description": "List of available case documents."
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      },
      "post": {
        "operationId": "addDocument",
        "summary": "Fill a permitted missing document slot",
        "parameters": [
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 50
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:-]+$"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Document"
                }
              }
            },
            "x-description-fr": "Création réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "metadata": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "verification_id": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "verification_id"
                    ]
                  },
                  "document": {
                    "type": "string",
                    "format": "binary"
                  }
                },
                "required": [
                  "metadata",
                  "document"
                ]
              },
              "encoding": {
                "metadata": {
                  "contentType": "application/json"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{reference}/documents/{document_id}": {
      "get": {
        "operationId": "downloadDocument",
        "summary": "Download an accessible document",
        "parameters": [
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 50
            }
          },
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Accept-Language",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fr",
                "en"
              ],
              "default": "fr"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Authenticated download. never a public storage URL.",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "x-description-fr": "Le fichier est renvoyé après vérification des droits."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        }
      }
    },
    "/v1/verification-statuses": {
      "get": {
        "operationId": "listVerificationStatuses",
        "summary": "List possible verification statuses",
        "parameters": [
          {
            "name": "Accept-Language",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fr",
                "en"
              ],
              "default": "fr"
            },
            "description": "Label language: fr (default) or en.",
            "x-description-fr": "Langue des libellés : fr par défaut, ou en."
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/VerificationStatusEntry"
                      },
                      "description": "Possible statuses. Known codes are unique; distinct unmapped labels remain separate.",
                      "x-description-fr": "Statuts possibles. Les codes connus sont uniques ; les libellés distincts avec le code unmapped restent séparés."
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            },
            "x-description-fr": "Requête réussie."
          },
          "400": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Requête invalide. Consultez le message d’erreur."
          },
          "401": {
            "description": "Missing or invalid token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Jeton absent, invalide ou expiré."
          },
          "403": {
            "description": "Operation not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Cet accès ne permet pas cette opération."
          },
          "404": {
            "description": "Resource absent or outside account scope",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Ressource introuvable ou inaccessible à ce compte."
          },
          "409": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "La requête entre en conflit avec une opération ou un état existant."
          },
          "413": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le contenu envoyé dépasse la taille autorisée."
          },
          "415": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Le format envoyé n’est pas accepté."
          },
          "422": {
            "description": "Request rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Une ou plusieurs données sont invalides. Consultez les détails de l’erreur."
          },
          "429": {
            "description": "Rate limit reached. Retry-After is in seconds",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 1
                },
                "description": "Seconds before retrying"
              }
            },
            "x-description-fr": "Trop de requêtes. Retry-After indique le délai d’attente en secondes."
          },
          "503": {
            "description": "Temporarily unavailable. no partial creation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-description-fr": "Service temporairement indisponible."
          }
        },
        "x-summary-fr": "Lister les statuts possibles des vérifications",
        "description": "Returns possible verification statuses, not the current statuses of a case. Known codes appear once. Labels are representative; use each verification status.label and status.color for display.",
        "x-description-fr": "Liste les statuts possibles des vérifications, pas les statuts courants d’un dossier. Chaque code connu apparaît une seule fois. Les libellés sont représentatifs ; utilisez status.label et status.color du point pour son affichage."
      }
    }
  },
  "components": {
    "securitySchemes": {
      "partnerOAuth": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "/oauth/token",
            "scopes": {}
          }
        }
      },
      "clientBasic": {
        "type": "http",
        "scheme": "basic"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "x-description-fr": "Code à utiliser pour identifier cette valeur dans votre logiciel.",
                "description": "Code used to identify this value in your software."
              },
              "message": {
                "type": "string",
                "x-description-fr": "Explication de l’erreur.",
                "description": "Explanation of the error."
              },
              "details": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "field": {
                      "type": "string",
                      "x-description-fr": "Nom du champ concerné par l’erreur.",
                      "description": "Name of the field affected by the error."
                    },
                    "code": {
                      "type": "string",
                      "x-description-fr": "Code à utiliser pour identifier cette valeur dans votre logiciel.",
                      "description": "Code used to identify this value in your software."
                    }
                  },
                  "required": [
                    "field",
                    "code"
                  ]
                },
                "x-description-fr": "Liste des champs invalides et des erreurs associées.",
                "description": "List of invalid fields and associated errors."
              },
              "request_id": {
                "type": "string",
                "x-description-fr": "Identifiant de l’appel à communiquer au support pour retrouver l’erreur.",
                "description": "Request identifier to give support when investigating the error."
              }
            },
            "required": [
              "code",
              "message",
              "request_id"
            ],
            "x-description-fr": "Informations sur l’erreur rencontrée.",
            "description": "Information about the error."
          }
        },
        "required": [
          "error"
        ]
      },
      "OAuthError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "error": {
            "type": "string",
            "x-description-fr": "Code de l’erreur d’authentification.",
            "description": "Authentication error code."
          },
          "error_description": {
            "type": "string",
            "x-description-fr": "Explication de l’erreur d’authentification.",
            "description": "Explanation of the authentication error."
          }
        },
        "required": [
          "error"
        ]
      },
      "Token": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "access_token": {
            "type": "string",
            "x-description-fr": "Jeton à envoyer dans l’en-tête Authorization: Bearer.",
            "description": "Token to send in the Authorization: Bearer header."
          },
          "token_type": {
            "type": "string",
            "enum": [
              "Bearer"
            ],
            "x-description-fr": "Type du jeton. La valeur est toujours Bearer.",
            "description": "Token type. Always Bearer."
          },
          "expires_in": {
            "type": "integer",
            "enum": [
              900
            ],
            "x-description-fr": "Durée de validité du jeton, en secondes.",
            "description": "Token lifetime in seconds."
          }
        },
        "required": [
          "access_token",
          "token_type",
          "expires_in"
        ]
      },
      "Status": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "description": "Language-independent status code. Additional codes may be returned. For checks, unmapped identifies a business state not yet assigned an explicit API code.",
            "x-description-fr": "Code du statut indépendant de la langue. D’autres codes peuvent être renvoyés. Pour une vérification, unmapped désigne un état métier pas encore associé à un code API explicite."
          },
          "label": {
            "type": "string",
            "description": "Client-facing status label. Its language follows Accept-Language when a translation exists.",
            "x-description-fr": "Libellé du statut affiché au client. Sa langue dépend de Accept-Language lorsque la traduction existe."
          },
          "color": {
            "type": "string",
            "pattern": "^#[0-9a-fA-F]{6}$",
            "description": "Color shown in the client application. The same status code may have different colors depending on context. Use the returned value. For a case, it reflects its checks and client-specific rules.",
            "x-description-fr": "Couleur affichée dans l’application client. Un même code de statut peut avoir plusieurs couleurs selon le contexte. Utilisez la valeur renvoyée. Pour un dossier, elle tient compte des vérifications et des règles du client."
          }
        },
        "required": [
          "code",
          "label"
        ]
      },
      "Candidate": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "first_name": {
            "type": "string",
            "maxLength": 200,
            "x-description-fr": "Prénom du candidat.",
            "description": "Candidate’s first name."
          },
          "last_name": {
            "type": "string",
            "maxLength": 200,
            "x-description-fr": "Nom du candidat.",
            "description": "Candidate’s last name."
          },
          "birth_name": {
            "type": "string",
            "maxLength": 200,
            "x-description-fr": "Nom de naissance du candidat.",
            "description": "Candidate’s birth name."
          },
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 200,
            "x-description-fr": "Adresse email du candidat.",
            "description": "Candidate’s email address."
          },
          "phone": {
            "type": "string",
            "maxLength": 41,
            "description": "Candidate’s phone number.",
            "x-description-fr": "Numéro de téléphone du candidat."
          },
          "street_number": {
            "type": "string",
            "maxLength": 100,
            "x-description-fr": "Numéro dans la rue.",
            "description": "Street number."
          },
          "street": {
            "type": "string",
            "maxLength": 100,
            "x-description-fr": "Nom de la rue.",
            "description": "Street name."
          },
          "postal_code": {
            "type": "string",
            "maxLength": 100,
            "x-description-fr": "Code postal.",
            "description": "Postal code."
          },
          "city": {
            "type": "string",
            "maxLength": 100,
            "x-description-fr": "Ville.",
            "description": "City."
          },
          "country": {
            "type": "string",
            "maxLength": 100,
            "x-description-fr": "Pays.",
            "description": "Country."
          },
          "birth_date": {
            "type": "string",
            "format": "date",
            "x-description-fr": "Date de naissance au format YYYY-MM-DD.",
            "description": "Birth date in YYYY-MM-DD format.",
            "maxLength": 10
          },
          "hiring_date": {
            "type": "string",
            "format": "date",
            "maxLength": 10,
            "description": "Hiring date in YYYY-MM-DD format. Required when hiring_date appears in required_candidate_fields. This requirement may be inherited from a parent group.",
            "x-description-fr": "Date d’embauche au format YYYY-MM-DD. Obligatoire si hiring_date figure dans required_candidate_fields. Cette obligation peut être héritée d’un groupe parent."
          }
        }
      },
      "Submitter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "integer",
            "x-description-fr": "Identifiant du déposant.",
            "description": "Identifier of the submitting account."
          },
          "name": {
            "type": "string",
            "x-description-fr": "Nom du compte déposant.",
            "description": "Submitting account name."
          },
          "default": {
            "type": "boolean",
            "x-description-fr": "Si true, ce compte est utilisé lorsque submitter_id est omis.",
            "description": "If true, this account is used when submitter_id is omitted."
          },
          "can_deposit_confidential": {
            "type": "boolean",
            "description": "Whether this API access can submit a confidential case for this account. Always false for additional submitters.",
            "x-description-fr": "Indique si cet accès API permet un dépôt confidentiel pour ce compte. Toujours false pour les déposants supplémentaires."
          }
        },
        "required": [
          "id",
          "name",
          "default",
          "can_deposit_confidential"
        ]
      },
      "ProfilePoint": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "label": {
            "type": "string",
            "x-description-fr": "Nom du point configuré, par exemple Diplôme 1.",
            "description": "Configured point name, for example Diploma 1."
          },
          "document_allowed": {
            "type": "boolean",
            "x-description-fr": "Indique si un document peut être joint à ce point lors du dépôt.",
            "description": "Whether a document can be attached to this point on submission."
          },
          "document_required": {
            "type": "boolean",
            "x-description-fr": "Indique si un document doit être joint à ce point lors du dépôt.",
            "description": "Whether a document must be attached to this point on submission."
          },
          "accepted_extensions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-description-fr": "Extensions de fichiers acceptées pour ce point.",
            "description": "File extensions accepted for this point."
          },
          "point_id": {
            "type": "integer",
            "description": "Catalogue point ID. Use it to attach a document to this point on submission.",
            "x-description-fr": "Identifiant du point dans le catalogue. À utiliser pour lui associer un document lors du dépôt."
          },
          "id_type": {
            "type": "integer",
            "nullable": true,
            "description": "Verification type ID. Several checks can share the same type.",
            "x-description-fr": "Identifiant du type de vérification. Plusieurs points peuvent avoir le même type."
          },
          "type": {
            "type": "string",
            "nullable": true,
            "description": "Verification type name. Null when no type is linked.",
            "x-description-fr": "Nom du type de vérification. Vaut null si aucun type n’est associé."
          }
        },
        "required": [
          "point_id",
          "label",
          "document_allowed",
          "document_required",
          "accepted_extensions",
          "id_type",
          "type"
        ],
        "description": "Points applied from the configured profile, ordered as in the client application."
      },
      "Profile": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "integer",
            "x-description-fr": "Identifiant du profil.",
            "description": "Identifier of the profile."
          },
          "name": {
            "type": "string",
            "x-description-fr": "Nom du profil configuré dans VerifCV.",
            "description": "Profile name configured in VerifCV."
          },
          "points": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProfilePoint"
            },
            "x-description-fr": "Points de vérification appliqués au dossier, dans l’ordre de l’application client.",
            "description": "Checks applied to the case, in client application order."
          },
          "required_candidate_fields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-description-fr": "Champs candidat obligatoires au dépôt. Une liste vide signifie qu’aucun champ supplémentaire n’est imposé.",
            "description": "Candidate fields required on submission. An empty list means no additional field is required."
          }
        },
        "required": [
          "id",
          "name",
          "points",
          "required_candidate_fields"
        ]
      },
      "AttachmentInput": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "part": {
            "type": "string",
            "pattern": "^attachment_[1-9][0-9]{0,2}$",
            "x-description-fr": "Nom de la partie multipart contenant le fichier, par exemple attachment_1.",
            "description": "Name of the multipart part containing the file, for example attachment_1."
          },
          "kind": {
            "type": "string",
            "enum": [
              "point",
              "general"
            ],
            "default": "point",
            "x-description-fr": "point pour rattacher la pièce à un point. general pour une pièce générale, si la configuration l’autorise.",
            "description": "point attaches the file to a check. general is a general file, when configuration allows it."
          },
          "point_id": {
            "type": "integer",
            "minimum": 1,
            "x-description-fr": "Identifiant du point dans le catalogue. À utiliser pour lui associer un document lors du dépôt.",
            "description": "Catalogue point ID. Use it to attach a document to this point on submission."
          }
        },
        "required": [
          "part"
        ]
      },
      "CreateCase": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "submitter_id": {
            "type": "integer",
            "minimum": 1,
            "x-description-fr": "Identifiant du déposant autorisé. Omettre pour utiliser le compte par défaut.",
            "description": "Permitted submitter ID. Omit to use the default account."
          },
          "document_type": {
            "type": "string",
            "enum": [
              "cv",
              "diploma"
            ],
            "default": "cv",
            "x-description-fr": "Type du document principal. cv par défaut. diploma nécessite une autorisation, un email et un téléphone.",
            "description": "Primary document type. Defaults to cv. diploma requires permission, an email and a phone number."
          },
          "profile_id": {
            "type": "integer",
            "minimum": 1,
            "x-description-fr": "Identifiant du profil choisi dans GET /v1/profiles. Obligatoire lorsque profile_required vaut true.",
            "description": "Profile ID chosen from GET /v1/profiles. Required when profile_required is true."
          },
          "candidate": {
            "$ref": "#/components/schemas/Candidate",
            "x-description-fr": "Informations du candidat.",
            "description": "Candidate information."
          },
          "comment": {
            "type": "string",
            "maxLength": 10000,
            "x-description-fr": "Commentaire ajouté au dépôt du dossier.",
            "description": "Comment added when submitting the case."
          },
          "documents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AttachmentInput"
            },
            "maxItems": 20,
            "x-description-fr": "Pièces supplémentaires à joindre. Chaque entrée désigne une partie multipart.",
            "description": "Extra documents to attach. Each entry identifies a multipart part."
          },
          "confidential": {
            "type": "boolean",
            "default": false,
            "description": "Whether the submission is confidential. Requires permission on the reference account and submission for that account.",
            "x-description-fr": "Indique un dépôt confidentiel. Nécessite l’habilitation du compte de référence et un dépôt pour ce compte."
          }
        },
        "description": "profile_id is required when custom profiles exist. Diploma mode must be enabled and requires candidate.email and candidate.phone. reference and external_reference are rejected. Omitted candidate fields may be filled by CV extraction; supplied fields are preserved."
      },
      "Document": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "x-description-fr": "Identifiant du document utilisé dans son URL de téléchargement. Il ne révèle pas son chemin de stockage.",
            "description": "Document ID used in its download URL. It does not reveal its storage path."
          },
          "name": {
            "type": "string",
            "x-description-fr": "Nom proposé pour enregistrer le fichier. Votre logiciel peut le renommer.",
            "description": "Suggested filename. Your software can rename it."
          },
          "content_type": {
            "type": "string",
            "x-description-fr": "Format du fichier, par exemple application/pdf.",
            "description": "File media type, for example application/pdf."
          },
          "size": {
            "type": "integer",
            "minimum": 0,
            "x-description-fr": "Taille du fichier en octets.",
            "description": "File size in bytes."
          },
          "verification_id": {
            "type": "integer",
            "nullable": true,
            "x-description-fr": "Identifiant de la vérification associée au document. Vaut null si le document est général.",
            "description": "ID of the check associated with the document. Null for a general document."
          },
          "download_url": {
            "type": "string",
            "x-description-fr": "Adresse de téléchargement à ajouter à la base URL de l’API. Le jeton Bearer reste nécessaire.",
            "description": "Download address to append to the API base URL. A Bearer token is still required."
          }
        },
        "required": [
          "id",
          "name",
          "content_type",
          "size",
          "verification_id",
          "download_url"
        ]
      },
      "Verification": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "x-description-fr": "Identifiant de la vérification du dossier.",
            "description": "Identifier of the case check."
          },
          "label": {
            "type": "string",
            "x-description-fr": "Libellé destiné à l’affichage.",
            "description": "Display label."
          },
          "status": {
            "$ref": "#/components/schemas/Status",
            "x-description-fr": "Statut visible dans l’application client.",
            "description": "Status shown in the client application."
          },
          "derogated": {
            "type": "boolean",
            "x-description-fr": "Indique si une dérogation est appliquée à cette vérification.",
            "description": "Whether this check has a derogation."
          },
          "details": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "code": {
                  "type": "string",
                  "x-description-fr": "Code à utiliser pour identifier cette valeur dans votre logiciel.",
                  "description": "Code used to identify this value in your software."
                },
                "label": {
                  "type": "string",
                  "x-description-fr": "Libellé destiné à l’affichage.",
                  "description": "Display label."
                },
                "value": {
                  "type": "string",
                  "nullable": true,
                  "x-description-fr": "Valeur du détail. Vaut null lorsqu’elle n’est pas renseignée.",
                  "description": "Detail value. Null when not provided."
                }
              },
              "required": [
                "code",
                "label",
                "value"
              ]
            },
            "x-description-fr": "Détails du résultat visibles par le client. La liste peut être vide.",
            "description": "Result details visible to the client. The list can be empty."
          },
          "comment": {
            "type": "string",
            "nullable": true,
            "x-description-fr": "Commentaire de la vérification visible par le client. Vaut null s’il est absent.",
            "description": "Check comment visible to the client. Null when absent."
          },
          "documents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Document"
            },
            "x-description-fr": "Documents associés à cette vérification et accessibles à cet accès API.",
            "description": "Documents associated with this check and available to this API access."
          },
          "can_upload_document": {
            "type": "boolean",
            "x-description-fr": "Indique si cet accès peut ajouter un document à cette vérification dans son état actuel.",
            "description": "Whether this access can add a document to this check in its current state."
          },
          "id_type": {
            "type": "integer",
            "description": "Verification type ID. Several checks can share the same type.",
            "x-description-fr": "Identifiant du type de vérification. Plusieurs points peuvent avoir le même type."
          }
        },
        "required": [
          "id",
          "label",
          "status",
          "derogated",
          "details",
          "documents",
          "can_upload_document",
          "id_type"
        ]
      },
      "Report": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "available": {
            "type": "boolean",
            "x-description-fr": "Indique si le rapport est disponible au téléchargement.",
            "description": "Whether the report is available for download."
          },
          "kind": {
            "type": "string",
            "enum": [
              "interim",
              "final",
              null
            ],
            "nullable": true,
            "x-description-fr": "Type du rapport disponible : final ou interim. Vaut null si aucun rapport n’est disponible.",
            "description": "Available report type: final or interim. Null when no report is available."
          },
          "download_url": {
            "type": "string",
            "nullable": true,
            "x-description-fr": "Adresse de téléchargement du rapport à ajouter à la base URL. Vaut null si le rapport est indisponible.",
            "description": "Report download address to append to the base URL. Null when unavailable."
          }
        },
        "required": [
          "available",
          "kind",
          "download_url"
        ]
      },
      "CaseSummary": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "reference": {
            "type": "string",
            "x-description-fr": "Référence du dossier. À utiliser pour le consulter ou le compléter.",
            "description": "Case reference. Use it to read or update the case."
          },
          "submitter_id": {
            "type": "integer",
            "x-description-fr": "Identifiant du compte déposant.",
            "description": "Submitting account ID."
          },
          "profile_id": {
            "type": "integer",
            "nullable": true,
            "x-description-fr": "Identifiant du profil appliqué. Vaut null si le dossier utilise la configuration de base.",
            "description": "Applied profile ID. Null when the case uses the base configuration."
          },
          "candidate": {
            "$ref": "#/components/schemas/Candidate",
            "x-description-fr": "Informations du candidat.",
            "description": "Candidate information."
          },
          "status": {
            "$ref": "#/components/schemas/Status",
            "x-description-fr": "Statut visible dans l’application client.",
            "description": "Status shown in the client application."
          },
          "progress": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "x-description-fr": "Avancement du dossier, de 0 à 100 %.",
            "description": "Case progress, from 0 to 100%."
          },
          "created_at": {
            "type": "integer",
            "description": "Creation time in Unix UTC seconds.",
            "x-description-fr": "Date de création, en secondes Unix UTC."
          },
          "updated_at": {
            "type": "integer",
            "description": "Last visible update time in Unix UTC seconds.",
            "x-description-fr": "Date de dernière modification visible, en secondes Unix UTC."
          }
        },
        "required": [
          "reference",
          "submitter_id",
          "profile_id",
          "candidate",
          "status",
          "progress",
          "created_at",
          "updated_at"
        ]
      },
      "Case": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "reference": {
            "type": "string",
            "x-description-fr": "Référence du dossier. À utiliser pour le consulter ou le compléter.",
            "description": "Case reference. Use it to read or update the case."
          },
          "submitter_id": {
            "type": "integer",
            "x-description-fr": "Identifiant du compte déposant.",
            "description": "Submitting account ID."
          },
          "profile_id": {
            "type": "integer",
            "nullable": true,
            "x-description-fr": "Identifiant du profil appliqué. Vaut null si le dossier utilise la configuration de base.",
            "description": "Applied profile ID. Null when the case uses the base configuration."
          },
          "candidate": {
            "$ref": "#/components/schemas/Candidate",
            "x-description-fr": "Informations du candidat.",
            "description": "Candidate information."
          },
          "status": {
            "$ref": "#/components/schemas/Status",
            "x-description-fr": "Statut visible dans l’application client.",
            "description": "Status shown in the client application."
          },
          "progress": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "x-description-fr": "Avancement du dossier, de 0 à 100 %.",
            "description": "Case progress, from 0 to 100%."
          },
          "created_at": {
            "type": "integer",
            "description": "Creation time in Unix UTC seconds.",
            "x-description-fr": "Date de création, en secondes Unix UTC."
          },
          "updated_at": {
            "type": "integer",
            "description": "Last visible update time in Unix UTC seconds.",
            "x-description-fr": "Date de dernière modification visible, en secondes Unix UTC."
          },
          "verifications": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Verification"
            },
            "x-description-fr": "Vérifications du dossier, dans l’ordre de l’application client.",
            "description": "Case checks in client application order."
          },
          "report": {
            "$ref": "#/components/schemas/Report",
            "x-description-fr": "Disponibilité du rapport et lien de téléchargement.",
            "description": "Report availability and download link."
          },
          "documents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Document"
            },
            "x-description-fr": "Documents accessibles avec cet accès API.",
            "description": "Documents available to this API access."
          }
        },
        "required": [
          "reference",
          "submitter_id",
          "profile_id",
          "candidate",
          "status",
          "progress",
          "created_at",
          "updated_at",
          "verifications",
          "report",
          "documents"
        ]
      },
      "CreatedCase": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "reference": {
            "type": "string",
            "x-description-fr": "Référence du dossier. À utiliser pour le consulter ou le compléter.",
            "description": "Case reference. Use it to read or update the case."
          },
          "submitter_id": {
            "type": "integer",
            "x-description-fr": "Identifiant du compte déposant.",
            "description": "Submitting account ID."
          },
          "status": {
            "$ref": "#/components/schemas/Status",
            "x-description-fr": "Statut visible dans l’application client.",
            "description": "Status shown in the client application."
          },
          "created_at": {
            "type": "integer",
            "x-description-fr": "Date de création, en secondes Unix UTC.",
            "description": "Creation time in Unix UTC seconds."
          }
        },
        "required": [
          "reference",
          "submitter_id",
          "status",
          "created_at"
        ]
      },
      "HistoryEvent": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "x-description-fr": "Identifiant de l’événement.",
            "description": "Identifier of the event."
          },
          "occurred_at": {
            "type": "integer",
            "x-description-fr": "Date de l’événement, en secondes Unix UTC.",
            "description": "Event time in Unix UTC seconds."
          },
          "label": {
            "type": "string",
            "x-description-fr": "Libellé destiné à l’affichage.",
            "description": "Display label."
          },
          "verification_id": {
            "type": "string",
            "nullable": true,
            "x-description-fr": "Identifiant de la vérification concernée. Vaut null si l’événement concerne le dossier entier.",
            "description": "Affected check ID. Null when the event concerns the whole case."
          },
          "details": {
            "type": "string",
            "nullable": true,
            "x-description-fr": "Informations complémentaires sur l’événement. Vaut null si elles sont absentes.",
            "description": "Additional event information. Null when absent."
          }
        },
        "required": [
          "id",
          "occurred_at",
          "label",
          "verification_id",
          "details"
        ]
      },
      "Pagination": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "type": "integer",
            "x-description-fr": "Nombre maximal d’éléments par page.",
            "description": "Maximum number of items per page."
          },
          "offset": {
            "type": "integer",
            "x-description-fr": "Nombre d’éléments ignorés avant cette page. La première page commence à 0.",
            "description": "Number of items skipped before this page. The first page starts at 0."
          },
          "total": {
            "type": "integer",
            "x-description-fr": "Nombre total d’éléments correspondant à la recherche.",
            "description": "Total number of matching items."
          },
          "next": {
            "type": "string",
            "nullable": true,
            "x-description-fr": "Adresse de la page suivante. Vaut null lorsqu’il n’y a plus de page.",
            "description": "Next page address. Null when there are no more pages."
          }
        },
        "required": [
          "limit",
          "offset",
          "total",
          "next"
        ]
      },
      "CaseList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CaseSummary"
            },
            "x-description-fr": "Dossiers de la page courante.",
            "description": "Cases on the current page."
          },
          "pagination": {
            "$ref": "#/components/schemas/CasePagination",
            "x-description-fr": "Informations pour parcourir les pages de résultats.",
            "description": "Information for browsing result pages."
          }
        },
        "required": [
          "data",
          "pagination"
        ]
      },
      "HistoryList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HistoryEvent"
            },
            "x-description-fr": "Événements de l’historique sur cette page.",
            "description": "History events on this page."
          },
          "pagination": {
            "$ref": "#/components/schemas/Pagination",
            "x-description-fr": "Informations pour parcourir les pages de résultats.",
            "description": "Information for browsing result pages."
          }
        },
        "required": [
          "data",
          "pagination"
        ]
      },
      "ProfileSummary": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "integer",
            "x-description-fr": "Identifiant du profil.",
            "description": "Identifier of the profile."
          },
          "name": {
            "type": "string",
            "x-description-fr": "Nom du profil configuré dans VerifCV.",
            "description": "Profile name configured in VerifCV."
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "CasePagination": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "type": "integer",
            "x-description-fr": "Nombre maximal d’éléments par page.",
            "description": "Maximum number of items per page."
          },
          "offset": {
            "type": "integer",
            "x-description-fr": "Nombre d’éléments ignorés avant cette page. La première page commence à 0.",
            "description": "Number of items skipped before this page. The first page starts at 0."
          },
          "total": {
            "type": "integer",
            "x-description-fr": "Nombre total d’éléments correspondant à la recherche.",
            "description": "Total number of matching items."
          },
          "next": {
            "type": "string",
            "nullable": true,
            "x-description-fr": "Adresse de la page suivante. Vaut null lorsqu’il n’y a plus de page.",
            "description": "Next page address. Null when there are no more pages."
          },
          "snapshot": {
            "type": "string",
            "nullable": true,
            "x-description-fr": "Identifiant de la sélection figée des dossiers. À conserver pour parcourir ses pages.",
            "description": "Identifier of the frozen case selection. Keep it when browsing its pages."
          },
          "snapshot_expires_at": {
            "type": "integer",
            "nullable": true,
            "x-description-fr": "Date d’expiration du snapshot, en secondes Unix UTC.",
            "description": "Snapshot expiry time in Unix UTC seconds."
          }
        },
        "required": [
          "limit",
          "offset",
          "total",
          "next"
        ]
      },
      "VerificationStatusEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "code",
          "label"
        ],
        "properties": {
          "code": {
            "type": "string",
            "description": "Language-independent API code. unmapped can occur for distinct results.",
            "x-description-fr": "Code API indépendant de la langue. unmapped peut désigner plusieurs résultats distincts."
          },
          "label": {
            "type": "string",
            "description": "Representative label in the requested language.",
            "x-description-fr": "Libellé représentatif dans la langue demandée."
          }
        }
      }
    }
  }
}
