Skip to main content
POST
/
risk-analysis
/
contracts
/
{contractId}
/
analyze
Iniciar Análise de Risco
curl --request POST \
  --url https://api.verifica.ia.br/risk-analysis/contracts/{contractId}/analyze \
  --header 'Authorization: Bearer <token>'
{
  "_id": "analysis-uuid",
  "contractId": "contract-uuid",
  "userId": "user-uuid",
  "status": "in_progress",
  "overallRisk": "MEDIUM",
  "riskScore": 0,
  "summary": "",
  "sections": [],
  "criticalIssues": [],
  "recommendations": [],
  "analyzedAt": {
    "$date": "2025-01-12T16:58:20.130Z"
  },
  "modelVersion": "1.0.0",
  "createdAt": {
    "$date": "2025-01-12T16:58:20.130Z"
  },
  "updatedAt": {
    "$date": "2025-01-12T16:58:20.130Z"
  },
  "__v": 0
}

Authorizations

​
Authorization
string
header
required

Token JWT obtido através do endpoint /auth/login.

Inclua o token no header: Authorization: Bearer SEU_TOKEN_JWT

Path Parameters

​
contractId
string<uuid>
required

ID do contrato a ser analisado

Response

Análise iniciada com sucesso

​
_id
string

ID único da análise

​
contractId
string<uuid>

ID do contrato analisado

​
userId
string<uuid>

ID do usuário proprietário

​
overallRisk
enum<string>

Nível de risco

Available options:
LOW,
MEDIUM,
HIGH
​
riskScore
integer

Score geral de risco (0-100)

Required range: 0 <= x <= 100
​
summary
string

Resumo da análise

​
sections
object[]
​
criticalIssues
object[]
​
recommendations
object[]
​
status
enum<string>

Status da análise

Available options:
pending,
in_progress,
completed,
failed
​
analyzedAt
object

Data e hora da análise

​
modelVersion
string

Versão do modelo de IA utilizado

​
learningContext
string

Contexto de aprendizado (opcional)

​
createdAt
object

Data de criação

​
updatedAt
object

Data de atualização

​
__v
integer

Versão do documento (MongoDB)