> ## Documentation Index > Fetch the complete documentation index at: https://docs.nlbs.ai/llms.txt > Use this file to discover all available pages before exploring further. # Listar processos judiciais da análise > Processos judiciais no snapshot desta análise, com sobreposição de última movimentação vinda da serving. Os agregados cobrem o conjunto filtrado do snapshot, não o corpus Mongo completo da entidade. ## OpenAPI ````yaml GET /analyses/{analysis_uuid}/legal-cases openapi: 3.1.0 info: description: Superfície pública da API para clientes autenticados por chave de API. title: NL Labs Gateway (Public API) version: 0.1.0 servers: - url: https://api.nlbs.ai security: [] tags: - description: Busca de entidades canônicas. name: entities - description: Criação, leitura, grafo e dossiê de análises. name: analyses - description: Relatório regulatório (COAF/SUSEP). name: reports - description: Triagem de mídia adversa. name: adverse-media - description: Versões do manifesto regulatório. name: regulatory - description: Versões do catálogo de regras do motor de risco. name: rules - description: Endpoints e eventos de webhook. name: webhooks - description: >- Entrypoints HTTP de workflow: invocar um workflow e consultar sua execução. name: workflow-endpoints paths: /analyses/{analysis_uuid}/legal-cases: get: tags: - analyses summary: Listar processos judiciais da análise description: >- Processos judiciais no snapshot desta análise, com sobreposição de última movimentação vinda da serving. Os agregados cobrem o conjunto filtrado do snapshot, não o corpus Mongo completo da entidade. operationId: list_analysis_legal_cases parameters: - in: path name: analysis_uuid required: true schema: format: uuid title: Analysis Uuid type: string - in: query name: q required: false schema: anyOf: - type: string - type: 'null' title: Q - in: query name: status required: false schema: anyOf: - items: $ref: '#/components/schemas/LegalCaseStatus' type: array - type: 'null' title: Status - in: query name: court_id required: false schema: anyOf: - type: integer - type: 'null' title: Court Id - in: query name: role required: false schema: anyOf: - items: $ref: '#/components/schemas/LegalCaseEntityRole' type: array - type: 'null' title: Role - in: query name: case_type required: false schema: anyOf: - items: $ref: '#/components/schemas/LegalCaseType' type: array - type: 'null' title: Case Type - in: query name: class_code required: false schema: anyOf: - items: type: string type: array - type: 'null' title: Class Code - in: query name: subject_code required: false schema: anyOf: - items: type: string type: array - type: 'null' title: Subject Code - description: Início inclusivo de filing_date. Não filtra last_movement_date. in: query name: from required: false schema: anyOf: - format: date type: string - type: 'null' description: Início inclusivo de filing_date. Não filtra last_movement_date. title: From - description: Fim inclusivo de filing_date. Não filtra last_movement_date. in: query name: to required: false schema: anyOf: - format: date type: string - type: 'null' description: Fim inclusivo de filing_date. Não filtra last_movement_date. title: To - in: query name: sort required: false schema: default: last_movement enum: - last_movement - filing_date - case_value title: Sort type: string - in: query name: order required: false schema: default: desc enum: - asc - desc title: Order type: string - in: query name: limit required: false schema: default: 20 maximum: 100 minimum: 1 title: Limit type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 title: Offset type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/AnalysisLegalCaseListResponse' description: Successful Response '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Chave de API ausente, malformada, expirada ou inválida. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: A chave de API autenticada não tem o escopo necessário. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Análise não encontrada. '422': description: >- Corpo da requisição, parâmetro de rota, parâmetro de query ou regra de negócio inválidos. components: schemas: LegalCaseStatus: enum: - active - closed - suspended - archived - pending - under_appeal - dismissed title: LegalCaseStatus type: string LegalCaseEntityRole: enum: - plaintiff - defendant - claimant - respondent - appellant - appellee - victim - investigated - defendant_criminal - convicted - witness - lawyer - prosecutor - judge - court - public_agency - interested_party - third_party - expert - other title: LegalCaseEntityRole type: string LegalCaseType: enum: - judicial - criminal - civil - labor - tax - electoral - administrative_judicial - constitutional - bankruptcy - enforcement - appeal - investigation title: LegalCaseType type: string AnalysisLegalCaseListResponse: additionalProperties: false properties: aggregates: $ref: '#/components/schemas/AnalysisLegalCaseAggregates' items: items: $ref: '#/components/schemas/AnalysisLegalCaseListItem' title: Items type: array total: title: Total type: integer required: - items - total - aggregates title: AnalysisLegalCaseListResponse type: object ErrorResponse: properties: detail: description: Mensagem de erro pública e estável. examples: - Resource not found. title: Detail type: string required: - detail title: ErrorResponse type: object AnalysisLegalCaseAggregates: additionalProperties: false properties: active: title: Active type: integer case_types: items: $ref: '#/components/schemas/AnalysisLegalCaseTypeFacet' title: Case Types type: array classes: items: $ref: '#/components/schemas/AnalysisLegalCaseCodeFacet' title: Classes type: array courts: items: $ref: '#/components/schemas/AnalysisLegalCaseCourtFacet' title: Courts type: array passive_pole: title: Passive Pole type: integer status_breakdown: $ref: '#/components/schemas/AnalysisLegalCaseStatusBreakdown' subjects: items: $ref: '#/components/schemas/AnalysisLegalCaseCodeFacet' title: Subjects type: array total: title: Total type: integer total_value: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string title: Total Value required: - total - active - passive_pole - total_value - status_breakdown title: AnalysisLegalCaseAggregates type: object AnalysisLegalCaseListItem: additionalProperties: false properties: case_number: anyOf: - type: string - type: 'null' title: Case Number case_status: anyOf: - $ref: '#/components/schemas/LegalCaseStatus' - type: 'null' case_type: anyOf: - $ref: '#/components/schemas/LegalCaseType' - type: 'null' case_value: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' title: Case Value classes: items: $ref: '#/components/schemas/AnalysisLegalCaseCodeEntry' title: Classes type: array court: anyOf: - $ref: '#/components/schemas/AnalysisLegalCaseCourt' - type: 'null' currency: anyOf: - type: string - type: 'null' title: Currency current_grau: anyOf: - $ref: '#/components/schemas/LegalCaseCurrentGrau' - type: 'null' filing_date: anyOf: - format: date type: string - type: 'null' title: Filing Date last_movement_date: anyOf: - format: date type: string - type: 'null' title: Last Movement Date last_movement_name: anyOf: - type: string - type: 'null' title: Last Movement Name legal_case_id: title: Legal Case Id type: string role: anyOf: - $ref: '#/components/schemas/LegalCaseEntityRole' - type: 'null' role_detail: anyOf: - type: string - type: 'null' title: Role Detail secrecy_level: anyOf: - $ref: '#/components/schemas/LegalCaseSecrecyLevel' - type: 'null' subject_is_party: default: true description: >- Sempre true: a lista só contém processos em que a entidade analisada é parte. Mantido por compatibilidade retroativa. title: Subject Is Party type: boolean subjects: items: $ref: '#/components/schemas/AnalysisLegalCaseCodeEntry' title: Subjects type: array required: - legal_case_id title: AnalysisLegalCaseListItem type: object AnalysisLegalCaseTypeFacet: additionalProperties: false properties: case_type: $ref: '#/components/schemas/LegalCaseType' count: title: Count type: integer required: - case_type - count title: AnalysisLegalCaseTypeFacet type: object AnalysisLegalCaseCodeFacet: additionalProperties: false properties: code: title: Code type: string count: title: Count type: integer name: anyOf: - type: string - type: 'null' title: Name required: - code - count title: AnalysisLegalCaseCodeFacet type: object AnalysisLegalCaseCourtFacet: additionalProperties: false properties: count: title: Count type: integer court_name: title: Court Name type: string id: title: Id type: integer required: - id - court_name - count title: AnalysisLegalCaseCourtFacet type: object AnalysisLegalCaseStatusBreakdown: additionalProperties: false properties: active: title: Active type: integer archived: title: Archived type: integer closed: title: Closed type: integer dismissed: title: Dismissed type: integer pending: title: Pending type: integer suspended: title: Suspended type: integer under_appeal: title: Under Appeal type: integer unknown: title: Unknown type: integer required: - active - closed - suspended - archived - pending - under_appeal - dismissed - unknown title: AnalysisLegalCaseStatusBreakdown type: object AnalysisLegalCaseCodeEntry: additionalProperties: false properties: code: title: Code type: string is_primary: default: false title: Is Primary type: boolean name: anyOf: - type: string - type: 'null' title: Name required: - code title: AnalysisLegalCaseCodeEntry type: object AnalysisLegalCaseCourt: additionalProperties: false properties: city: anyOf: - type: string - type: 'null' title: City court_code: anyOf: - type: string - type: 'null' title: Court Code court_name: title: Court Name type: string id: title: Id type: integer state: anyOf: - type: string - type: 'null' title: State required: - id - court_name title: AnalysisLegalCaseCourt type: object LegalCaseCurrentGrau: enum: - G1 - G2 - JE - SUP title: LegalCaseCurrentGrau type: string LegalCaseSecrecyLevel: enum: - public - restricted - sealed - secret title: LegalCaseSecrecyLevel type: string ````