Skip to main content
GET

Quando usar

Use este endpoint quando você quer só a leitura interpretada do relatório: o parecer de cada seção (texto, score, nível de risco e destaques) e o resumo da deliberação do comitê, sem trazer os payloads pesados de integração. Casos típicos:
  • Alimentar um agente de IA ou um LLM do seu lado com contexto barato, em vez de mandar o relatório inteiro.
  • Montar uma tela de resumo executivo no seu sistema.
  • Verificar se os pareceres já terminaram antes de convocar o comitê.
  • Buscar o detalhe depois de receber o webhook COMMITTEE_FINISHED.
Para os dados completos do relatório, use GET /v2/report/{id}. Para os votos individuais dos agentes e a auditoria da deliberação, use GET /committee/deliberations/{reportId}.

Autenticação

Bearer JWT no header Authorization. A credencial precisa da permissão de leitura de relatórios pela API. Um id de outra organização retorna 404.

Parâmetros

Só estas 22 seções produzem parecer, e portanto só elas fazem sentido como filtro: BASIC_INFORMATION, LOCATION, RELATIONS, SCORE, POSITIVE_REGISTRY, PROCESSES, JUDGMENTS, CERTIFICATES, LICENSES_AUTHORIZATIONS, PEP, SANCTIONS, MEDIA_EXPOSURE, CRIMINAL_RECORD, SOCIAL_ASSISTANCE_PROGRAMS, SECTOR, SCR, SCR_SUMMARY, PEFIN, REFIN, PROTESTS, BAD_CHECK, PAST_DUE_DEBT. A análise financeira não entra aqui: a leitura de IA do balanço está na seção FINANCIAL_INSIGHTS, em Consultar Seção por Tipo.
Filtrar por um tipo de seção que existe mas não produz parecer (por exemplo SUMMARY, BALANCE_SHEET ou CREDIT_POLICY) não é erro: a requisição retorna 200 com insights vazio. O mesmo vale para uma seção com parecer que ainda não terminou. Lista completa dos tipos e quais recebem parecer em Consultar Seção por Tipo.

Resposta

O envelope é o mesmo com ou sem filtro; com section, o array insights vem com um único item.
Só entram no array as seções com parecer concluído. Um relatório ainda em processamento retorna insights vazio ou parcial, e committee.status null. Isso é o esperado, não é erro.

Próximos passos

Comitê de Crédito IA

Como os pareceres viram uma decisão.

Convocar Comitê

Levar o relatório a comitê sob demanda.

Pareceres GYRA+ IA

O que é um parecer de seção.

Seções do Relatório

Catálogo de seções e seus tipos.

Authorizations

Authorization
string
header
required

Enter JWT token

Path Parameters

id
string
required

ID do relatorio.

Query Parameters

section
string

Filtra o parecer de UMA secao (ex: PROCESSES, SCR, PEFIN). Sem o parametro, retorna todos os pareceres concluidos. Tipo de secao invalido responde 400; secao sem parecer responde insights vazio.

Response

Envelope com reportId, document, committee { status, decision, result, at } e insights[] (parecer por secao).

Pareceres por secao e o resumo da decisao do comite. A leitura completa esta em /concepts/pareceres-gyra-ia.