# Forecast API

> Forecast is an AI-powered project and resource management (PSA) platform for
> project-driven companies. The Forecast REST API is a complete programmable
> interface to Forecast functionality: projects, tasks, time registrations,
> allocations, people, clients, rate cards, invoices, and webhooks. JSON over
> HTTPS, authenticated with a per-integration API key. Forecast was acquired by
> Accelo (2025); the forecast.app brand now redirects to accelo.com, while the
> api.forecast.it API remains operational.

Generated by the API Evangelist enrichment pipeline from apis.yml and repo
artifacts. Not an official Forecast publication.

## API

- Base URL: https://api.forecast.it/api/v1/ (TLS only, JSON only)
- Versioning: per-resource path segment; resources expose v1-v4 independently
- Auth: static API key in the `X-FORECAST-API-KEY` header (Admin -> API Keys)
- Errors: custom JSON envelope `{ "status": <int>, "message": <string> }`
- Pagination: `pageNumber` / `pageSize` query params -> `pageContents` array
- Fair use policy: https://www.forecast.app/fair-use-policy

## Documentation

- API docs (GitHub): https://github.com/Forecast-it/API
- API documentation article: https://support.forecast.app/hc/en-us/articles/5153680387473-API-Documentation
- Using API keys: https://support.forecast.app/hc/en-us/articles/33378026998289-Using-API-Keys
- Help center: https://support.forecast.app/hc/en-us

## Core resources

- Projects: GET/POST/PUT/DELETE /v1/projects
- Tasks: GET /v4/tasks, GET /v3/tasks/{id}, POST /v3/tasks
- Time registrations: GET /v4/time_registrations, POST /v1/time_registrations
- Allocations: GET/POST/PUT/DELETE /v1/allocations
- Persons: GET /v2/persons, GET /v1/persons/{id}/utilization, timer start/stop
- Clients: GET/POST/PUT/DELETE /v1/clients
- Webhook subscriptions: GET/POST/PUT/DELETE /v1/webhook_subscriptions

## Events / Webhooks

- Subscribe to TASK, TIME_REG, PROJECT, PHASE objects on CREATE/UPDATE/DELETE
- Delivery: HTTPS POST with { timestamp, event, object.id, person.id, fields_changed }
- Retries: up to 5 attempts, backoff 1/2/3/5/10 minutes on non-2xx

## Repo artifacts

- authentication/forecast-authentication.yml
- conventions/forecast-conventions.yml
- errors/forecast-problem-types.yml
- lifecycle/forecast-lifecycle.yml
- conformance/forecast-conformance.yml
- asyncapi/forecast-webhooks.yml
- data-model/forecast-data-model.yml
- mcp/forecast-mcp.yml (candidate)
- security/forecast-domain-security.yml
- security/forecast-trust-center.yml
- security/forecast-vulnerability-disclosure.yml
- skills/

## Company

- Website (redirects to Accelo): https://www.forecast.app/
- Now Accelo: https://www.accelo.com/forecast
- Pricing: https://www.forecast.app/pricing
- Blog: https://www.forecast.app/blog
- GitHub org: https://github.com/Forecast-it
- Backed by (pre-acquisition): Balderton Capital