> ## Documentation Index
> Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Consultar Deliberação do Comitê
> Retorna a deliberação completa do Comitê de Crédito IA para um relatório, com o voto de cada agente e os dados de auditoria.
**Este endpoint não está respondendo em produção.** Verificado com um relatório cujo comitê concluiu (`committeeStatus: "DONE"`): a chamada retorna `404`. O proxy para o serviço de IA não resolve a rota.
Enquanto isso não é corrigido, **use [`GET /report/{id}/insights`](/api-reference/report/get-reportinsights)**: o campo `committee.result` traz a deliberação completa, com `synthesis`, os `agentOpinions` dos sete agentes, `deliberationId`, `confidence`, `costUsd`, `durationMs` e `models`. É a mesma informação descrita abaixo.
### Quando usar
Use este endpoint quando precisa da **deliberação completa e auditável**: o voto individual de cada um dos sete agentes, os alertas que cada um levantou, o registro de divergência, a versão de prompt usada e a telemetria (modelos, tokens, custo e duração).
É o endpoint de **auditoria e compliance**. Para o dia a dia da integração (decisão + pareceres), [`GET /report/{id}/insights`](/api-reference/report/get-reportinsights) é mais leve e costuma bastar.
Retorna sempre a deliberação **mais recente** do relatório. Reconvocações (`trigger: "RERUN"`) geram uma nova deliberação, e é ela que passa a ser devolvida.
### Autenticação
Bearer JWT no header `Authorization`. A busca é restrita à organização do token.
### Parâmetros
| Nome | Local | Tipo | Obrigatório | Descrição |
| ---------- | ------ | -------- | ----------- | --------------------------------- |
| `reportId` | `path` | `string` | `sim` | ID do relatório que foi a comitê. |
### Resposta
| Campo | Descrição |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | ID da deliberação. |
| `reportId` | Relatório deliberado. |
| `policyId` / `policyVersion` | Política e versão vigentes na deliberação. |
| `trigger` | `AUTO_SUGGEST`, `AUTO_DECIDE`, `MANUAL` ou `RERUN`. |
| `status` | `RUNNING`, `DONE` ou `ERROR`. |
| `agentOpinions[]` | Um objeto por agente: `agent`, `agentLabel`, `score` (0 a 10), `resumo`, `parecer`, `redFlags[]`, `positiveFactors[]`, `confidence`, `infoGaps[]`, `recommendation`, `model`, `costUsd` e `sectionsSeen[]`. |
| `synthesis` | Saída do Presidente: `decision`, `resumo`, `reasoning`, `proximaAcao`, `conditions[]`, `dissentLog[]`, `monitoringItems[]`, `infoGapsBeforeDecision[]`, `limitReview`, `confidence`, `alcadaLevel`. |
| `finalRecommendation` | `APPROVED`, `REJECTED`, `REQUIRES_ALCADA` ou `NEEDS_INFO`. |
| `confidence` | Confiança agregada da deliberação (0 a 1). |
| `promptVersion` | Versão do prompt-base GYRA+ usada. |
| `customPrompts` | `true` quando a organização tinha instruções adicionais ativas. |
| `promptVersionsByAgent` | Versão de prompt base e da organização por agente. Permite rastrear a relação entre uma mudança de instrução e a decisão. |
| `totalInputTokens` / `totalOutputTokens` / `totalCostUsd` | Telemetria de consumo da deliberação. |
| `webSearchRequests` | Buscas na web feitas pelo agente Cadastral. |
| `durationMs` | Duração total da deliberação. |
| `modelVersions` | Modelos usados por etapa. |
| `error` | Preenchido quando `status` é `ERROR`. |
```bash cURL theme={null}
curl --location 'https://gyra-core.gyramais.com.br/committee/deliberations/6612a7f30000000000000001' \
--header 'Authorization: Bearer {seu_token_jwt}'
```
```javascript JavaScript theme={null}
fetch("https://gyra-core.gyramais.com.br/committee/deliberations/6612a7f30000000000000001", {
method: "GET",
headers: { "Authorization": "Bearer {seu_token_jwt}" },
})
.then(res => res.json())
.then(console.log)
```
```python Python theme={null}
import requests
url = "https://gyra-core.gyramais.com.br/committee/deliberations/6612a7f30000000000000001"
headers = {"Authorization": "Bearer {seu_token_jwt}"}
response = requests.get(url, headers=headers)
print(response.json())
```
```json 200 OK theme={null}
{
"id": "6612a7f30000000000000900",
"reportId": "6612a7f30000000000000001",
"organizationId": "6612a7f30000000000000001",
"policyId": "6612a7f30000000000000010",
"policyVersion": 3,
"trigger": "MANUAL",
"status": "DONE",
"agentOpinions": [
{
"agent": "cadastral",
"agentLabel": "Cadastral",
"score": 8,
"resumo": "Cadastro íntegro e atividade coerente com o CNAE declarado.",
"parecer": "A empresa está ativa desde 2014, sem mudanças recentes de endereço...",
"redFlags": [],
"positiveFactors": [
{ "label": "Empresa madura", "detail": "12 anos de operação no mesmo endereço." }
],
"confidence": 0.9,
"infoGaps": [],
"recommendation": "APPROVE",
"model": "claude-sonnet-4-6",
"costUsd": 0.052,
"sectionsSeen": ["BASIC_INFORMATION", "LOCATION", "CERTIFICATES"]
},
{
"agent": "comportamental",
"agentLabel": "Comportamental",
"score": 6,
"resumo": "Concentração relevante em conta garantida pede atenção.",
"parecer": "O mix de produtos indica dependência de linha rotativa...",
"redFlags": [
{ "severity": "WARNING", "label": "Concentração em conta garantida", "detail": "62% da carteira." }
],
"positiveFactors": [],
"confidence": 0.78,
"infoGaps": [],
"recommendation": "APPROVE_WITH_RESTRICTION",
"model": "claude-sonnet-4-6",
"costUsd": 0.061,
"sectionsSeen": ["SCR", "PEFIN", "PROTESTS"]
}
],
"synthesis": {
"decision": "APPROVED",
"resumo": "Aprovar com ressalvas: caixa e histórico sustentam a operação, com atenção à concentração em rotativo.",
"reasoning": "Seis dos sete agentes recomendaram aprovação...",
"proximaAcao": "Solicitar garantia adicional antes do desembolso.",
"conditions": ["Garantia adicional de 20% do limite"],
"dissentLog": [
{ "agent": "comportamental", "divergedHow": "Alertou para concentração em conta garantida acima de 60%." }
],
"monitoringItems": ["Acompanhar evolução do SCR nos próximos 3 meses"],
"infoGapsBeforeDecision": [],
"limitReview": {
"status": "ADEQUADO",
"limite": "R$ 250.000,00",
"taxa": "2,1% a.m.",
"prazo": "12 meses",
"justificativa": "Limite compatível com o faturamento apurado."
},
"confidence": 0.82,
"alcadaLevel": null
},
"finalRecommendation": "APPROVED",
"confidence": 0.82,
"promptVersion": "v8",
"customPrompts": true,
"promptVersionsByAgent": {
"cadastral": { "baseVersion": 8, "orgVersion": 2 },
"comportamental": { "baseVersion": 8, "orgVersion": 1 }
},
"totalInputTokens": 184320,
"totalOutputTokens": 9840,
"totalCostUsd": 0.41,
"webSearchRequests": 3,
"durationMs": 38210,
"modelVersions": { "specialists": "claude-sonnet-4-6", "synthesizer": "claude-sonnet-4-6" },
"error": null,
"createdAt": "2026-07-30T14:30:33.812Z",
"updatedAt": "2026-07-30T14:31:12.004Z"
}
```
```json 404 Not Found theme={null}
{
"code": 404,
"message": "Nenhuma deliberação do comitê encontrada para este relatório."
}
```
```json 401 Unauthorized theme={null}
{
"code": 401,
"message": "Token de acesso inválido."
}
```
### Próximos passos
Agentes, decisões e modos de convocação.
Disparar uma nova deliberação.
Versão enxuta, para o fluxo do dia a dia.
Receber `COMMITTEE_FINISHED`.