> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Get file detail (admin)

> Returns a single remittance or return file scoped to the resolved institution (the id resolves the remittance table first, then the return table). Its content is the base64-encoded decrypted body only when the caller is authorized for cleartext access; otherwise the content is elided. A file belonging to another institution returns 404.



## OpenAPI

````yaml en/openapi/v3-current/sisbajud.yaml get /v1/admin/files/{id}
openapi: 3.0.3
info:
  title: Lerian SISBAJUD API
  description: >-
    API for Lerian SISBAJUD — the participant-side rail that integrates the
    institution with Banco Central do Brasil's SISBAJUD (Sistema de Busca de
    Ativos do Poder Judiciário) system for judicial asset blocking and
    unblocking. It covers judicial-order administration, remittance and return
    file management, reconciliation, SLA monitoring, LGPD data-subject requests,
    and per-institution configuration and connector credentials.
  version: v1.0.0
servers:
  - url: https://sisbajud.sandbox.lerian.net
security: []
tags:
  - name: Admin
    description: >-
      Administrative operations over judicial orders: listing and detail,
      failed-order reprocessing, remittance and return file access,
      reconciliation runs and status, SLA-risk monitoring, processing
      statistics, audit-trail verification, cross-organization subject
      summaries, and LGPD data-subject requests and justifications.
  - name: Institution
    description: >-
      Per-institution configuration and connector credentials: configuration
      upsert with tokenization-keyset provisioning, safe configuration read, and
      outbound connector credential registration and rotation.
paths:
  /v1/admin/files/{id}:
    get:
      tags:
        - Admin
      summary: Get file detail (admin)
      description: >-
        Returns a single remittance or return file scoped to the resolved
        institution (the id resolves the remittance table first, then the return
        table). Its content is the base64-encoded decrypted body only when the
        caller is authorized for cleartext access; otherwise the content is
        elided. A file belonging to another institution returns 404.
      parameters:
        - description: Remittance or return file id (UUID)
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminFileDetailResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
components:
  schemas:
    http.AdminFileDetailResponse:
      properties:
        content:
          description: >-
            Content is the base64-encoded decrypted file body, returned ONLY
            when the

            caller is authorized for cleartext access (all PII classes
            revealed);

            otherwise it is elided — the field is OMITTED entirely (omitempty),
            never

            partially redacted and never an empty placeholder.
          type: string
        created_at:
          type: string
        environment:
          type: string
        file_category:
          type: string
        file_hash:
          type: string
        file_name:
          type: string
        file_type:
          type: string
        generation_date:
          type: string
        id:
          type: string
        institution_code:
          type: string
        record_count:
          type: integer
        status:
          type: string
        updated_at:
          type: string
      type: object
    http.AdminErrorResponse:
      properties:
        code:
          type: string
        details:
          additionalProperties: {}
          type: object
        message:
          type: string
        title:
          type: string
      type: object

````