{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/signdocs-com-br/json-schema/signdocs-com-br-enrollment-status-response-schema.json",
  "title": "EnrollmentStatusResponse",
  "description": "Situação do enrollment biométrico de um usuário.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/signdocs-com-br-users-api-openapi.yml#/components/schemas/EnrollmentStatusResponse",
  "type": "object",
  "properties": {
    "userExternalId": {
      "type": "string"
    },
    "enrollmentSource": {
      "type": "string",
      "description": "Origem do cadastro em vigor, sempre na forma canônica — enviar\n`BANK_PROVIDED` devolve `ORGANIZATION_PROVIDED`. Cadastros feitos\nantes de setembro de 2026 podem devolver `BANK_PROVIDED`.\n",
      "enum": [
        "ORGANIZATION_PROVIDED",
        "FIRST_LIVENESS",
        "DOCUMENT_PHOTO",
        "BANK_PROVIDED"
      ]
    },
    "enrollmentVersion": {
      "type": "integer",
      "description": "Incrementa a cada novo PUT para o mesmo usuário."
    },
    "enrollmentHash": {
      "type": "string",
      "description": "SHA-256 da imagem de referência em vigor."
    },
    "enrolledAt": {
      "type": "string",
      "format": "date-time"
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "description": "Momento em que a imagem de referência é apagada pelo ciclo de vida\ndo S3 (`enrolledAt` + `retentionDays`). Depois disso a etapa de\ncomparação falha com 422 até haver novo cadastro.\n"
    },
    "expired": {
      "type": "boolean",
      "description": "`true` quando `expiresAt` já passou — recadastre.\n\nO registro sobrevive à imagem de propósito, por 30 dias, justamente\npara que uma varredura de recadastramento encontre `expired: true`.\nPassada essa folga o registro também é apagado, e a mesma consulta\npassa a responder 404 — que é indistinguível de \"nunca cadastrado\".\nQuem depende disso deve varrer dentro da folga, não depois.\n"
    },
    "retentionDays": {
      "type": "integer",
      "description": "Janela de retenção de dados biométricos, em dias."
    },
    "maskedCpf": {
      "type": "string",
      "description": "Últimos 4 dígitos do CPF, prefixados por `***`."
    },
    "faceConfidence": {
      "type": "number",
      "format": "double",
      "description": "Confiança da detecção facial no momento do cadastro (0-100)."
    },
    "documentImageHash": {
      "type": "string",
      "description": "Presente apenas em enrollment com `source: DOCUMENT_PHOTO`."
    }
  }
}