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

> Esta rota é normalmente utilizada para campos de autocomplete, e buscas mais simples, pois é uma rota que entrega menos informações que uma busca avançada. Se você estiver buscando encontrar projetos baseado em um conjunto de filtros avançados e específicos, considere usar a busca avançada.

Possui paginação e aceita alguns filtros via query params, consulte:

- [Filtro básico](https://docs.olie.ai/api-reference/general/basic-filters)



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/projects
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/projects:
    get:
      tags:
        - projects
      summary: Listar projetos
      description: >-
        Esta rota é normalmente utilizada para campos de autocomplete, e buscas
        mais simples, pois é uma rota que entrega menos informações que uma
        busca avançada. Se você estiver buscando encontrar projetos baseado em
        um conjunto de filtros avançados e específicos, considere usar a busca
        avançada.


        Possui paginação e aceita alguns filtros via query params, consulte:


        - [Filtro
        básico](https://docs.olie.ai/api-reference/general/basic-filters)
      parameters:
        - name: page
          in: query
          required: false
          description: Número da página a ser retornada. Começa em 1
          schema:
            type: integer
            default: 1
            minLength: 1
          example: 1
        - name: perPage
          in: query
          required: false
          description: >-
            Quantidade de itens exibidos por página. Define o tamanho da página
            de resultados
          schema:
            type: integer
            default: 30
            minLength: 1
            maxLength: 100
          example: 30
        - name: filter
          in: query
          description: >-
            Permite aplicar filtros aos resultados da listagem. Use a sintaxe
            `filter[campo]=valor` para filtrar por campos específicos. Campos
            disponíveis variam por recurso. Consulte a documentação sobre
            [filtros
            básicos](https://docs.olie.ai/api-reference/general/basic-filters)
          schema:
            type: string
            default: <string>
          example: <string>
        - name: search
          in: query
          required: false
          description: Filtrar projetos pelo nome ou código
          schema:
            type: string
            default: <string>
          example: Hopper
        - name: trashed
          in: query
          required: false
          description: Filtrar deletados
          schema:
            type: boolean
            default: <boolean>
          example: true
        - name: template
          in: query
          required: false
          description: Filtrar projetos templates
          schema:
            type: boolean
            default: <boolean>
          example: true
        - name: sort
          in: query
          required: false
          description: 'Campo usado para ordenação. Ex: name, created_at, etc.'
          schema:
            type: string
            default: <string>
          example: name
        - name: direction
          in: query
          required: false
          description: 'Direção da ordenação: asc (crescente) ou desc (decrescente).'
          schema:
            type: string
            enum:
              - asc
              - desc
          example: asc
      responses:
        '200':
          description: Sucesso
          headers:
            Date:
              schema:
                type: string
              example: Tue, 16 Dec 2025 12:23:39 GMT
            Transfer-Encoding:
              schema:
                type: string
              example: chunked
            Connection:
              schema:
                type: string
              example: keep-alive
            Cache-Control:
              schema:
                type: string
              example: private, must-revalidate
            pragma:
              schema:
                type: string
              example: no-cache
            expires:
              schema:
                type: integer
              example: -1
            X-RateLimit-Limit:
              schema:
                type: integer
              example: 160
            X-RateLimit-Remaining:
              schema:
                type: integer
              example: 158
            Access-Control-Allow-Origin:
              schema:
                type: string
              example: '*'
            Access-Control-Expose-Headers:
              schema:
                type: string
              example: '*'
        '401':
          description: Não autorizado
          headers:
            Transfer-Encoding:
              schema:
                type: string
              example: chunked
            Connection:
              schema:
                type: string
              example: keep-alive
            Cache-Control:
              schema:
                type: string
              example: no-cache, private
            access-control-allow-origin:
              schema:
                type: string
              example: '*'
            access-control-expose-headers:
              schema:
                type: string
              example: '*'
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````