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

# Listar arquivos (admin)

> Lista os metadados de arquivos de remessa ou de retorno da instituição resolvida (type seleciona a tabela; remittance é o padrão) com paginação por offset e um filtro de status opcional. Os itens são apenas metadados não sensíveis; o download do conteúdo do arquivo é um endpoint separado.



## OpenAPI

````yaml pt/openapi/v3-current/sisbajud.yaml get /v1/admin/files
openapi: 3.0.3
info:
  title: Lerian SISBAJUD API
  description: >-
    API do Lerian SISBAJUD — o rail do lado do participante que integra a
    instituição ao sistema SISBAJUD (Sistema de Busca de Ativos do Poder
    Judiciário) do Banco Central do Brasil para o bloqueio e desbloqueio
    judicial de ativos. Abrange a administração de ordens judiciais, a gestão de
    arquivos de remessa e de retorno, a conciliação, o monitoramento de SLA, as
    solicitações de titulares de dados LGPD e a configuração por instituição e
    as credenciais de conector.
  version: v1.0.0
servers:
  - url: https://sisbajud.sandbox.lerian.net
security: []
tags:
  - name: Admin
    description: >-
      Operações administrativas sobre ordens judiciais: listagem e detalhe,
      reprocessamento de ordens com falha, acesso a arquivos de remessa e de
      retorno, execuções e status de conciliação, monitoramento de risco de SLA,
      estatísticas de processamento, verificação da trilha de auditoria, resumos
      de titulares entre organizações e solicitações e justificativas de
      titulares de dados LGPD.
  - name: Institution
    description: >-
      Configuração por instituição e credenciais de conector: upsert de
      configuração com provisionamento do conjunto de chaves de tokenização,
      leitura segura da configuração e registro e rotação de credenciais de
      conector de saída.
paths:
  /v1/admin/files:
    get:
      tags:
        - Admin
      summary: Listar arquivos (admin)
      description: >-
        Lista os metadados de arquivos de remessa ou de retorno da instituição
        resolvida (type seleciona a tabela; remittance é o padrão) com paginação
        por offset e um filtro de status opcional. Os itens são apenas metadados
        não sensíveis; o download do conteúdo do arquivo é um endpoint separado.
      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

````