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

# Listar operações de planilha

> Lista operações de import/export assíncronas. Suporta paginação e filtros por `action` e `status`.



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/spreadsheet-operations
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/spreadsheet-operations:
    parameters:
      - name: page
        in: query
        description: Número da página a ser retornada. Começa em 1
        schema:
          type: integer
        example: 1
      - name: perPage
        in: query
        description: >-
          Quantidade de itens exibidos por página. Define o tamanho da página de
          resultados
        schema:
          type: integer
        example: 30
      - name: filter[action]
        in: query
        description: 'Filtra pelo tipo de operação: `import` ou `export`.'
        schema:
          type: string
          enum:
            - import
            - export
        example: export
      - name: filter[status]
        in: query
        description: >-
          Filtra pelo status exato: `pending`, `processing`, `completed` ou
          `failed`.
        schema:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
        example: completed
    get:
      tags:
        - spreadsheet-operations
        - index
      summary: Listar operações de planilha
      description: >-
        Lista operações de import/export assíncronas. Suporta paginação e
        filtros por `action` e `status`.
      operationId: listarOperacoesDePlanilha
      responses:
        '200':
          description: Lista de operações de planilha retornada com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: boolean
                    example: true
                  meta:
                    type: object
                    title: Informações de Paginação
                    description: Metadados de paginação
                    properties:
                      current_page:
                        type: integer
                        example: 1
                      from:
                        type: integer
                        example: 1
                      last_page:
                        type: integer
                        example: 1
                      per_page:
                        type: integer
                        example: 30
                      to:
                        type: integer
                        example: 30
                      total:
                        type: integer
                        example: 5
                  spreadsheet_operations:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        action:
                          type: string
                          example: export
                        type:
                          type: string
                          example: project
                        status:
                          type: string
                          example: completed
                        total_rows:
                          type: integer
                          example: 120
                        processed_rows:
                          type: integer
                          example: 120
                        percentage:
                          type: integer
                          example: 100
                        errors_count:
                          type: integer
                          example: 0
                        metadata:
                          type: object
                        file_name:
                          type: string
                          example: project_2026-06-01-143022.xlsx
                        initiator_type:
                          type: string
                          example: App\Models\User
                        initiator_id:
                          type: string
                          format: uuid
                        initiator:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            name:
                              type: string
                            avatar_url:
                              type: string
                        started_at:
                          type: string
                          format: date-time
                        completed_at:
                          type: string
                          format: date-time
                        created_at:
                          type: string
                          format: date-time
                        updated_at:
                          type: string
                          format: date-time
              example:
                response: true
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  per_page: 30
                  to: 30
                  total: 5
                spreadsheet_operations:
                  - id: 019dd427-5d13-71bf-9a09-d75aa2bf4bd7
                    action: export
                    type: project
                    status: completed
                    total_rows: 120
                    processed_rows: 120
                    percentage: 100
                    errors_count: 0
                    metadata:
                      columns:
                        - project.id
                        - project.name
                      filters: []
                    file_name: project_2026-06-01-143022.xlsx
                    initiator_type: App\Models\User
                    initiator_id: 019c75de-50f0-7366-a948-b8cbdd1841be
                    initiator:
                      id: 019c75de-50f0-7366-a948-b8cbdd1841be
                      name: Tester
                      avatar_url: https://via.placeholder.com/124x124.png/00aa99?text=quas
                    started_at: '2026-06-01T14:30:22.000000Z'
                    completed_at: '2026-06-01T14:31:10.000000Z'
                    created_at: '2026-06-01T14:30:22.000000Z'
                    updated_at: '2026-06-01T14:31:10.000000Z'
        '401':
          description: Não autenticado
        '403':
          description: Sem permissão
        '422':
          description: Campos inválidos
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````