> ## 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.

# Consultar análise

> Retorna o veredito determinístico já persistido da análise.



## OpenAPI

````yaml GET /analyses/{analysis_uuid}
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}:
    get:
      tags:
        - analyses
      summary: Consultar análise
      description: Retorna o veredito determinístico já persistido da análise.
      operationId: get_analysis
      parameters:
        - in: path
          name: analysis_uuid
          required: true
          schema:
            format: uuid
            title: Analysis Uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalysisResponse'
          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 para o cliente autenticado.
        '422':
          description: >-
            Corpo da requisição, parâmetro de rota, parâmetro de query ou regra
            de negócio inválidos.
components:
  schemas:
    AnalysisResponse:
      properties:
        risk:
          anyOf:
            - $ref: '#/components/schemas/AnalysisRiskSummary'
            - type: 'null'
        subject:
          anyOf:
            - $ref: '#/components/schemas/SubjectProfile'
            - type: 'null'
        uuid:
          format: uuid
          title: Uuid
          type: string
        versions:
          anyOf:
            - $ref: '#/components/schemas/AnalysisVersionsSummary'
            - type: 'null'
      required:
        - uuid
      title: AnalysisResponse
      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
    AnalysisRiskSummary:
      properties:
        risk_level:
          $ref: '#/components/schemas/RiskLevel'
          description: Classificação de risco derivada do score.
        score:
          description: Score final de risco, 0-100.
          maximum: 100
          minimum: 0
          title: Score
          type: integer
      required:
        - score
        - risk_level
      title: AnalysisRiskSummary
      type: object
    SubjectProfile:
      additionalProperties: false
      properties:
        age_range_code:
          anyOf:
            - maximum: 9
              minimum: 0
              type: integer
            - type: 'null'
          title: Age Range Code
        age_years:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Age Years
        birth_country:
          anyOf:
            - type: string
            - type: 'null'
          title: Birth Country
        birth_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Birth Date
        birth_state:
          anyOf:
            - type: string
            - type: 'null'
          title: Birth State
        capital_social:
          anyOf:
            - type: number
            - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
              type: string
            - type: 'null'
          title: Capital Social
        citizenship:
          anyOf:
            - type: string
            - type: 'null'
          title: Citizenship
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
        company_size:
          anyOf:
            - type: string
            - type: 'null'
          title: Company Size
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        death_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Death Status
        display_name:
          minLength: 1
          title: Display Name
          type: string
        document:
          anyOf:
            - type: string
            - type: 'null'
          title: Document
        document_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Type
        education_level:
          anyOf:
            - $ref: '#/components/schemas/PersonEducationLevel'
            - type: 'null'
        employee_count:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Employee Count
        entity_id:
          exclusiveMinimum: 0
          title: Entity Id
          type: integer
        entity_type:
          $ref: '#/components/schemas/EntityType'
        establishment_type:
          anyOf:
            - $ref: '#/components/schemas/EstablishmentType'
            - type: 'null'
        father_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Father Name
        federal_entity_responsible:
          anyOf:
            - type: string
            - type: 'null'
          title: Federal Entity Responsible
        gender:
          anyOf:
            - $ref: '#/components/schemas/PersonGender'
            - type: 'null'
        government_branch:
          anyOf:
            - $ref: '#/components/schemas/OrganizationGovernmentBranch'
            - type: 'null'
        headquarters_entity_id:
          anyOf:
            - exclusiveMinimum: 0
              type: integer
            - type: 'null'
          title: Headquarters Entity Id
        incorporation_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Incorporation Date
        is_headquarters:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Headquarters
        last_registry_update:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Last Registry Update
        legal_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Legal Name
        legal_nature_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Legal Nature Code
        legal_nature_description:
          anyOf:
            - type: string
            - type: 'null'
          title: Legal Nature Description
        main_cnae_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Main Cnae Code
        main_cnae_description:
          anyOf:
            - type: string
            - type: 'null'
          title: Main Cnae Description
        marital_status:
          anyOf:
            - $ref: '#/components/schemas/PersonMaritalStatus'
            - type: 'null'
        mei_end_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Mei End Date
        mei_option:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Mei Option
        mei_start_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Mei Start Date
        mother_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Mother Name
        nationality:
          anyOf:
            - type: string
            - type: 'null'
          title: Nationality
        normalized_name:
          minLength: 1
          title: Normalized Name
          type: string
        organization_category:
          anyOf:
            - $ref: '#/components/schemas/OrganizationCategory'
            - type: 'null'
        partner_count:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Partner Count
        place_of_birth:
          anyOf:
            - type: string
            - type: 'null'
          title: Place Of Birth
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Postal Code
        primary_address:
          anyOf:
            - type: string
            - type: 'null'
          title: Primary Address
        race_color:
          anyOf:
            - $ref: '#/components/schemas/PersonRaceColor'
            - type: 'null'
        registration_status_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Registration Status Reason
        registration_status_reason_code:
          anyOf:
            - type: integer
            - type: 'null'
          title: Registration Status Reason Code
        secondary_cnae_codes:
          items:
            type: string
          title: Secondary Cnae Codes
          type: array
        simples_nacional_end_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Simples Nacional End Date
        simples_nacional_option:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Simples Nacional Option
        simples_nacional_start_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Simples Nacional Start Date
        special_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Special Status
        special_status_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Special Status Date
        state:
          anyOf:
            - type: string
            - type: 'null'
          title: State
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
        status_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Status Date
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        ubo_count:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Ubo Count
        unit_status:
          anyOf:
            - $ref: '#/components/schemas/OrganizationUnitStatus'
            - type: 'null'
        unit_status_since:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Unit Status Since
        unit_type:
          anyOf:
            - $ref: '#/components/schemas/OrganizationUnitType'
            - type: 'null'
      required:
        - entity_id
        - entity_type
        - display_name
        - normalized_name
      title: SubjectProfile
      type: object
    AnalysisVersionsSummary:
      properties:
        engine_fingerprint:
          description: Hash que identifica a versão de comportamento do motor.
          title: Engine Fingerprint
          type: string
        input_fingerprint:
          description: Hash dos insumos de enriquecimento usados.
          title: Input Fingerprint
          type: string
        rules_version:
          description: Versão do catálogo determinístico de regras usada.
          title: Rules Version
          type: string
        snapshot_hash:
          anyOf:
            - type: string
            - type: 'null'
          description: Hash do payload do snapshot.
          title: Snapshot Hash
        verdict_fingerprint:
          description: Hash de tudo que vem depois do snapshot.
          title: Verdict Fingerprint
          type: string
      required:
        - rules_version
        - engine_fingerprint
        - input_fingerprint
        - verdict_fingerprint
      title: AnalysisVersionsSummary
      type: object
    RiskLevel:
      enum:
        - low
        - medium
        - high
        - critical
      title: RiskLevel
      type: string
    PersonEducationLevel:
      enum:
        - illiterate
        - reads_writes
        - elementary_incomplete
        - elementary_complete
        - secondary_incomplete
        - secondary_complete
        - higher_incomplete
        - higher_complete
      title: PersonEducationLevel
      type: string
    EntityType:
      enum:
        - person
        - organization
        - government_agency
        - financial_institution
        - political_party
        - foreign_entity
        - vessel
        - aircraft
        - notary_office
        - unknown
      title: EntityType
      type: string
    EstablishmentType:
      enum:
        - headquarters
        - branch
      title: EstablishmentType
      type: string
    PersonGender:
      enum:
        - M
        - F
      title: PersonGender
      type: string
    OrganizationGovernmentBranch:
      enum:
        - executivo
        - legislativo
        - judiciario
      title: OrganizationGovernmentBranch
      type: string
    PersonMaritalStatus:
      enum:
        - single
        - married
        - divorced
        - widowed
        - stable_union
        - separated
      title: PersonMaritalStatus
      type: string
    OrganizationCategory:
      enum:
        - private_company
        - public_company
        - government_agency
        - nonprofit
        - association
        - foundation
        - political_party
        - financial_institution
        - foreign_company
        - other
      title: OrganizationCategory
      type: string
    PersonRaceColor:
      enum:
        - white
        - black
        - brown
        - yellow
        - indigenous
      title: PersonRaceColor
      type: string
    OrganizationUnitStatus:
      enum:
        - ativo
        - extinto
        - em_liquidacao
      title: OrganizationUnitStatus
      type: string
    OrganizationUnitType:
      enum:
        - orgao
        - entidade
        - unidade_adm
        - colegiado
      title: OrganizationUnitType
      type: string

````