> ## 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. # Get regulatory report > Return the persisted regulatory report and its complete result. ## OpenAPI ````yaml https://api.qa.nlbs.ai/api/openapi.json get /reports/{report_uuid} openapi: 3.1.0 info: description: >- NL Labs AI AML API. Use Bearer API keys for protected endpoints. The /live and /ready probes are public. title: NL Labs AI version: 0.1.0 servers: - url: https://api.qa.nlbs.ai/api security: - ApiKeyAuth: [] tags: - description: Runtime health checks and source freshness endpoints. name: health - description: Canonical entity lookup endpoints used before starting analyses. name: entities - description: AML analysis creation, status, result, and debug endpoints. name: analyses - description: Regulatory report (Motor 2) creation, status, result, and debug endpoints. name: reports - description: Versioned deterministic rules catalog endpoints. name: rules - description: Versioned regulatory reference catalog endpoints. name: regulatory - description: Webhook endpoint configuration and delivery-event operations. name: webhooks paths: /reports/{report_uuid}: get: tags: - reports summary: Get regulatory report description: Return the persisted regulatory report and its complete result. operationId: get_report parameters: - description: Report execution UUID. in: path name: report_uuid required: true schema: description: Report execution UUID. format: uuid title: Report Uuid type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ReportResponse' description: Successful Response '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Missing, malformed, expired, or invalid Bearer API key. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: The authenticated API key does not have the required scope. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Report was not found for the authenticated client. '422': description: >- Invalid request body, path parameter, query parameter, or business rule. security: - HTTPBearer: [] components: schemas: ReportResponse: description: >- Complete regulatory report returned by POST and GET /reports/{uuid}. A synchronously-returned report is always COMPLETED; failures do not persist, so the queue-lifecycle fields (status/error/timestamps) are dropped. `result` carries the XML/PDF storage references (bucket/key/uri) — artifacts live in MinIO, not inline in the response. properties: analysis_uuid: description: Source analysis UUID. format: uuid title: Analysis Uuid type: string institution_type: $ref: '#/components/schemas/InstitutionType' description: Institution type used. result: anyOf: - $ref: '#/components/schemas/ReportResult' - type: 'null' description: Complete assembled report result. uuid: description: Report execution UUID. format: uuid title: Uuid type: string required: - uuid - analysis_uuid - institution_type - result title: ReportResponse type: object ErrorResponse: properties: detail: description: Stable public error message. examples: - Resource not found. title: Detail type: string required: - detail title: ErrorResponse type: object InstitutionType: description: >- Type of supervised institution requesting the regulatory report. The institution type selects the applicable sector norm (regime) used when resolving regulatory references and prompting the narrative agent. enum: - banco - seguradora title: InstitutionType type: string ReportResult: additionalProperties: false description: >- Complete regulatory report assembled by the Motor 2 workflow. Each report topic is a ready-to-display PT-BR text string. The deterministic sections (§1, §2, §3, §7) are always present; the narrative sections (§4–§6) are ``None`` when the single narrative agent could not produce a valid result, with the matching limitation recorded in ``limitations``. properties: audit_trail: title: Audit Trail type: string coaf_communication_draft: anyOf: - type: string - type: 'null' title: Coaf Communication Draft coaf_xml: anyOf: - $ref: '#/components/schemas/ReportXmlArtifact' - type: 'null' consolidated_risk_signals: title: Consolidated Risk Signals type: string counterparty_identification: title: Counterparty Identification type: string enquadramento_suggestion: anyOf: - type: string - type: 'null' title: Enquadramento Suggestion institution_type: $ref: '#/components/schemas/InstitutionType' legal_basis: anyOf: - type: string - type: 'null' title: Legal Basis limitations: items: $ref: '#/components/schemas/AnalysisLimitation' title: Limitations type: array ownership_and_ubo: title: Ownership And Ubo type: string pdf: anyOf: - $ref: '#/components/schemas/ReportPdfArtifact' - type: 'null' regime: $ref: '#/components/schemas/RegulatoryRegime' source_analysis_uuid: format: uuid title: Source Analysis Uuid type: string versions: $ref: '#/components/schemas/ReportVersions' required: - source_analysis_uuid - institution_type - regime - counterparty_identification - ownership_and_ubo - consolidated_risk_signals - audit_trail - versions title: ReportResult type: object ReportXmlArtifact: additionalProperties: false description: >- Reference to the generated COAF/COS XML filing stored in object storage. Deterministic artifact. ``available`` is ``False`` only when no XML can be produced because the regime's official leiaute is not implemented yet (e.g. bank/BCB); the ``limitations`` explain why and the rest of the report is unaffected. A real serialization or storage-upload error is not represented here — it fails the step. ``limitations`` may also be non-empty on an available artifact when optional operation data was missing (partial filing). properties: available: title: Available type: boolean byte_size: anyOf: - minimum: 0 type: integer - type: 'null' title: Byte Size content_type: default: application/xml title: Content Type type: string filename: anyOf: - type: string - type: 'null' title: Filename format: title: Format type: string limitations: items: $ref: '#/components/schemas/AnalysisLimitation' title: Limitations type: array regime: $ref: '#/components/schemas/RegulatoryRegime' storage_bucket: anyOf: - type: string - type: 'null' title: Storage Bucket storage_key: anyOf: - type: string - type: 'null' title: Storage Key storage_uri: anyOf: - type: string - type: 'null' title: Storage Uri required: - regime - format - available title: ReportXmlArtifact type: object AnalysisLimitation: additionalProperties: false description: >- Structured description of missing, partial, or constrained analysis data. properties: code: minLength: 1 pattern: ^[a-z][a-z0-9_]*$ title: Code type: string details: additionalProperties: true title: Details type: object entity_id: anyOf: - exclusiveMinimum: 0 type: integer - type: 'null' title: Entity Id message: minLength: 1 title: Message type: string required: - code - message title: AnalysisLimitation type: object ReportPdfArtifact: additionalProperties: false description: >- Reference to the generated human-readable PDF report stored in object storage. Presentation artifact (best-effort): ``available`` is ``False`` when the PDF could not be rendered or stored; in that case ``limitations`` explains why and the rest of the report (JSON + XML) is unaffected. The PDF is a rendering of the assembled report sections; it is not a regulatory filing. properties: available: title: Available type: boolean byte_size: anyOf: - minimum: 0 type: integer - type: 'null' title: Byte Size content_type: default: application/pdf title: Content Type type: string filename: anyOf: - type: string - type: 'null' title: Filename limitations: items: $ref: '#/components/schemas/AnalysisLimitation' title: Limitations type: array storage_bucket: anyOf: - type: string - type: 'null' title: Storage Bucket storage_key: anyOf: - type: string - type: 'null' title: Storage Key storage_uri: anyOf: - type: string - type: 'null' title: Storage Uri required: - available title: ReportPdfArtifact type: object RegulatoryRegime: description: Sector regulatory regime selected from the institution type. enum: - BCB - SUSEP title: RegulatoryRegime type: string ReportVersions: additionalProperties: false description: Version identifiers recorded with the generated report. properties: model: anyOf: - type: string - type: 'null' title: Model narrative_prompt_version: anyOf: - type: string - type: 'null' title: Narrative Prompt Version regulatory_catalog_version: minLength: 1 title: Regulatory Catalog Version type: string report_workflow_version: minLength: 1 title: Report Workflow Version type: string source_analysis_workflow_version: anyOf: - type: string - type: 'null' title: Source Analysis Workflow Version required: - report_workflow_version - regulatory_catalog_version title: ReportVersions type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````