> ## 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 por data de previsão > Agrupa os projetos de um funil pelos meses de previsão informados. Para cada par ano/mês a resposta traz os projetos com data prevista naquele mês, a contagem e a soma dos orçamentos — é o que alimenta a visão de calendário do funil. Aceita os mesmos filtros da [busca avançada](https://docs.olie.ai/api-reference/general/advanced-search), aplicados a todos os meses da consulta. ## OpenAPI ````yaml /api-reference/openapi.json post /api/management/get-projects-by-forecast-dates 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/get-projects-by-forecast-dates: post: tags: - projects - Métricas e previsão summary: Listar projetos por data de previsão description: >- Agrupa os projetos de um funil pelos meses de previsão informados. Para cada par ano/mês a resposta traz os projetos com data prevista naquele mês, a contagem e a soma dos orçamentos — é o que alimenta a visão de calendário do funil. Aceita os mesmos filtros da [busca avançada](https://docs.olie.ai/api-reference/general/advanced-search), aplicados a todos os meses da consulta. operationId: obterProjetosPorDatasDePrevisO requestBody: content: application/json: schema: description: Funil e meses da consulta. type: object properties: project_funnel_id: type: integer description: ID do funil consultado. dates: type: array description: Meses a consultar. items: description: Mês consultado. type: object properties: year: type: integer description: Ano da previsão. month: type: integer minimum: 1 maximum: 12 description: Mês da previsão, de 1 a 12. filters: type: array description: Filtros aplicados aos projetos de todos os meses. items: description: Um filtro da busca avançada. type: object properties: field: type: string description: Campo a filtrar. operator: type: string enum: - equals - not_equals - contains - not_contains - greater_than - greater_than_or_equals - less_than - less_than_or_equals - is_null - is_not_null description: Operador da comparação. logical_operator: type: string description: >- Como o filtro se junta ao anterior: `and` (padrão) ou `or`. arguments: type: array description: Argumentos extras exigidos por alguns filtros. items: description: Argumento do filtro. required: - field - operator required: - project_funnel_id - dates example: project_funnel_id: null dates: - year: 2026 month: 9 filters: [] responses: '200': description: Sucesso content: application/json: schema: description: Projetos agrupados por mês de previsão. type: object properties: response: type: boolean description: Sempre true quando a operação é concluída. dates_with_projects: type: array description: Um grupo por mês consultado, na ordem enviada. items: description: Projetos de um mês. type: object properties: date: type: object description: Mês a que o grupo se refere. properties: year: type: integer description: Ano consultado. month: type: integer description: Mês consultado. projects: type: array description: Projetos com previsão naquele mês. items: type: object description: Projeto. properties: id: type: string description: ID (UUID) do projeto. format: uuid frame_id: type: string description: ID (UUID) da conta dona do projeto. format: uuid code: type: string description: >- Código do projeto, formado pelo prefixo e por um número sequencial. name: type: string description: Nome do projeto. description: type: string description: Descrição do projeto. status: type: integer description: >- Situação: 1 em andamento, 2 concluído, 3 arquivado, 4 parado. impact: type: integer description: Grau de impacto, de 1 a 10. budget: type: number description: Orçamento do projeto. is_template: type: boolean description: Indica se o projeto é um modelo. parent_id: type: string description: >- ID do projeto pai, quando este é um subprojeto. format: uuid customer_id: type: string description: ID do cliente vinculado. format: uuid contact_id: type: string description: ID do contato vinculado. format: uuid created_by: type: string description: ID do usuário que criou o projeto. format: uuid created_at: type: string description: Data de criação. format: date-time updated_at: type: string description: Data da última alteração. format: date-time deleted_at: type: string description: Data em que foi enviado para a lixeira. format: date-time projects_count: type: integer description: Quantidade de projetos no mês. projects_budget: type: number description: Soma dos orçamentos do mês. required: - response - dates_with_projects example: response: true dates_with_projects: - date: year: 2026 month: 9 projects: - id: 019e0edb-aa7c-70c4-9d2d-3a2f175b5ddf code: SC-1 name: Shopping Center status: 1 impact: 9 budget: 340000 forecast_date: '2026-09-14' projects_count: 1 projects_budget: 340000 - date: year: 2026 month: 10 projects: [] projects_count: 0 projects_budget: 0 '422': description: Validação falhou content: application/json: schema: type: object properties: response: type: boolean description: Sempre false em respostas de erro. message: type: string description: >- Identificador do erro, usado pelo cliente para tratar o caso. error: type: string description: Descrição legível do erro. validation: type: object description: >- Mapa de campo para as mensagens de validação daquele campo. properties: {} required: - response - message - error - validation example: response: false message: validation_errors error: O campo project funnel id é obrigatório. (and 1 more error) validation: project_funnel_id: - O campo project funnel id é obrigatório. dates: - O campo dates é obrigatório. components: securitySchemes: BearerAuth: type: http scheme: bearer ````