> ## 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 uma versão do catálogo regulatório

> Retorna o manifesto e o catálogo de uma versão regulatória específica.



## OpenAPI

````yaml GET /regulatory/versions/{version}
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:
  /regulatory/versions/{version}:
    get:
      tags:
        - regulatory
      summary: Consultar uma versão do catálogo regulatório
      description: Retorna o manifesto e o catálogo de uma versão regulatória específica.
      operationId: get_regulatory_version
      parameters:
        - description: Rótulo da versão do catálogo regulatório.
          in: path
          name: version
          required: true
          schema:
            description: Rótulo da versão do catálogo regulatório.
            examples:
              - 0.1.0
            title: Version
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegulatoryVersionSnapshotResponse'
          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: Versão do catálogo regulatório não encontrada.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    RegulatoryVersionSnapshotResponse:
      properties:
        catalog:
          $ref: '#/components/schemas/RegulatoryCatalogResponse'
          description: Payload congelado do catálogo regulatório.
        manifest:
          $ref: '#/components/schemas/RegulatoryManifestResponse'
          description: Metadados do manifesto do snapshot.
      required:
        - manifest
        - catalog
      title: RegulatoryVersionSnapshotResponse
      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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    RegulatoryCatalogResponse:
      properties:
        documents:
          items:
            $ref: '#/components/schemas/RegulatoryDocumentSummary'
          title: Documents
          type: array
        references:
          items:
            $ref: '#/components/schemas/RegulatoryReferenceSummary'
          title: References
          type: array
      title: RegulatoryCatalogResponse
      type: object
    RegulatoryManifestResponse:
      examples:
        - catalog_hash: sha256:example
          document_count: 12
          published_at: '2026-06-23T00:00:00Z'
          reference_count: 80
          version: 0.1.0
      properties:
        catalog_hash:
          description: Hash determinístico do payload do catálogo regulatório.
          examples:
            - sha256:example
          title: Catalog Hash
          type: string
        document_count:
          description: Número de documentos-fonte.
          examples:
            - 12
          title: Document Count
          type: integer
        published_at:
          description: Timestamp de publicação deste snapshot regulatório.
          examples:
            - '2026-06-23T00:00:00Z'
          format: date-time
          title: Published At
          type: string
        reference_count:
          description: Número de referências regulatórias.
          examples:
            - 80
          title: Reference Count
          type: integer
        version:
          description: Versão semântica do catálogo regulatório.
          examples:
            - 0.1.0
          title: Version
          type: string
      required:
        - version
        - published_at
        - catalog_hash
        - document_count
        - reference_count
      title: RegulatoryManifestResponse
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    RegulatoryDocumentSummary:
      properties:
        authority:
          title: Authority
          type: string
        code:
          title: Code
          type: string
        document_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Number
        effective_from:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Effective From
        effective_until:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Effective Until
        jurisdiction:
          anyOf:
            - type: string
            - type: 'null'
          title: Jurisdiction
        official_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Official Url
        published_at:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Published At
        status:
          $ref: '#/components/schemas/RegulatoryDocumentStatus'
        title:
          title: Title
          type: string
        type:
          $ref: '#/components/schemas/RegulatoryDocumentType'
        version:
          title: Version
          type: string
      required:
        - code
        - version
        - type
        - authority
        - title
        - status
      title: RegulatoryDocumentSummary
      type: object
    RegulatoryReferenceSummary:
      properties:
        application_notes:
          items:
            type: string
          title: Application Notes
          type: array
        code:
          title: Code
          type: string
        document_code:
          title: Document Code
          type: string
        locator:
          anyOf:
            - type: string
            - type: 'null'
          title: Locator
        relevant_context:
          items:
            type: string
          title: Relevant Context
          type: array
        risk_indicators:
          items:
            type: string
          title: Risk Indicators
          type: array
        summary:
          title: Summary
          type: string
        title:
          title: Title
          type: string
        version:
          title: Version
          type: string
      required:
        - code
        - version
        - document_code
        - title
        - summary
      title: RegulatoryReferenceSummary
      type: object
    RegulatoryDocumentStatus:
      enum:
        - active
        - revoked
        - superseded
        - historical
        - unknown
      title: RegulatoryDocumentStatus
      type: string
    RegulatoryDocumentType:
      enum:
        - law
        - complementary_law
        - provisional_measure
        - regulation
        - normative_instruction
        - typology_collection
        - guidance
        - recommendation
        - sanctions_program
        - sanctions_list
        - jurisprudence
        - other
      title: RegulatoryDocumentType
      type: string

````