> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/connect/n8n-api/insights.md).

# Insights

Operations about insights

## Retrieve insights summary

> Retrieve the insights summary for the selected date range.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Insights","description":"Operations about insights"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"}}},"paths":{"/insights/summary":{"get":{"operationId":"getInsightsSummary","tags":["Insights"],"summary":"Retrieve insights summary","description":"Retrieve the insights summary for the selected date range.","parameters":[{"schema":{"type":"string","format":"date-time","description":"ISO 8601 start date. Defaults to 7 days ago."},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string","format":"date-time","description":"ISO 8601 end date. Defaults to now."},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string","description":"Project identifier to filter insights by project."},"required":false,"name":"projectId","in":"query"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"object","properties":{"value":{"type":"number"},"deviation":{"type":"number","nullable":true},"unit":{"type":"string","enum":["count"]}},"required":["value","deviation","unit"]},"failed":{"type":"object","properties":{"value":{"type":"number"},"deviation":{"type":"number","nullable":true},"unit":{"type":"string","enum":["count"]}},"required":["value","deviation","unit"]},"failureRate":{"type":"object","properties":{"value":{"type":"number"},"deviation":{"type":"number","nullable":true},"unit":{"type":"string","enum":["ratio"]}},"required":["value","deviation","unit"]},"timeSaved":{"type":"object","properties":{"value":{"type":"number"},"deviation":{"type":"number","nullable":true},"unit":{"type":"string","enum":["minute"]}},"required":["value","deviation","unit"]},"averageRunTime":{"type":"object","properties":{"value":{"type":"number"},"deviation":{"type":"number","nullable":true},"unit":{"type":"string","enum":["millisecond"]}},"required":["value","deviation","unit"]}},"required":["total","failed","failureRate","timeSaved","averageRunTime"]}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"}}}}}}
```