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

# List files (admin)

> Lists the resolved institution's remittance or return file metadata (type selects the table; remittance is the default) with offset pagination and an optional status filter. Items are non-sensitive metadata only; file content download is a separate endpoint.



## OpenAPI

````yaml en/openapi/v3-current/sisbajud.yaml get /v1/admin/files
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:
    get:
      tags:
        - Admin
      summary: List files (admin)
      description: >-
        Lists the resolved institution's remittance or return file metadata
        (type selects the table; remittance is the default) with offset
        pagination and an optional status filter. Items are non-sensitive
        metadata only; file content download is a separate endpoint.
      parameters:
        - description: 'File table: remittance | return (default remittance)'
          in: query
          name: type
          schema:
            type: string
        - description: >-
            File status filter (validated against the selected type's status
            enum)
          in: query
          name: status
          schema:
            type: string
        - description: Page size (coerced into [1, 200]; default 20)
          in: query
          name: limit
          schema:
            type: integer
        - description: Row offset (coerced to >= 0; default 0)
          in: query
          name: offset
          schema:
            type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminFilePage'
        '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'
        '422':
          description: Unprocessable Entity
          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.AdminFilePage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/http.AdminFileListItem'
          type: array
        limit:
          type: integer
        offset:
          type: integer
        total:
          type: integer
      type: object
    http.AdminErrorResponse:
      properties:
        code:
          type: string
        details:
          additionalProperties: {}
          type: object
        message:
          type: string
        title:
          type: string
      type: object
    http.AdminFileListItem:
      properties:
        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
        transmission_date:
          type: string
        updated_at:
          type: string
      type: object

````