> For the complete documentation index, see [llms.txt](https://api-docs.myhappyforce.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.myhappyforce.com/docs/api-reference/innovation-stats-resource.md).

# Innovation Stats Resource

## GET /api/v1/company/stats/innovation

>

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"InnovationAggregatedResultDTO":{"type":"object","properties":{"byPersonRatio":{"type":"number","format":"double"},"innovationScore":{"type":"number","format":"double"},"valuation":{"$ref":"#/components/schemas/ValuationType"},"totalIdeas":{"type":"integer","format":"int32"},"ideasInInitiative":{"type":"integer","format":"int32"},"previousTotalIdeas":{"type":"integer","format":"int32"},"finishedInitiatives":{"type":"integer","format":"int32"},"activeInitiatives":{"type":"integer","format":"int32"},"previousActiveInitiatives":{"type":"integer","format":"int32"},"previousFinishedInitiatives":{"type":"integer","format":"int32"},"ideasDistribution":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/IdeasDistribution"},"description":"Distribution of ideas by feedback status phase","properties":{"NO_PHASE":{"$ref":"#/components/schemas/IdeasDistribution"},"ONGOING":{"$ref":"#/components/schemas/IdeasDistribution"},"DISCARDED":{"$ref":"#/components/schemas/IdeasDistribution"},"ACCEPTED":{"$ref":"#/components/schemas/IdeasDistribution"}}},"ideasByStatus":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/IdeasDistribution"}}}},"ValuationType":{"type":"string","description":"Valuation of data of a specific field or metric; usually based on the participation of employees in a survey or the number of responses to a question.","enum":["NO_DATA","BAD","WARNING","NEUTRAL","GOOD","EXCELLENT"]},"IdeasDistribution":{"type":"object","properties":{"numIdeas":{"type":"integer","format":"int32"},"numIdeasInitiatives":{"type":"integer","format":"int32"}}}}},"paths":{"/api/v1/company/stats/innovation":{"get":{"tags":["innovation-stats-resource"],"operationId":"getInnovationStats","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"hierarchyIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"filters","in":"query","required":false,"schema":{"type":"string"}},{"name":"groupId","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InnovationAggregatedResultDTO"}}}}}}}}}
```

## GET /api/v1/company/stats/innovation/ranking

>

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"InnovationRankingResultDTO":{"type":"object","properties":{"type":{"type":"string","enum":["USER","HIERARCHY"]},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"ranking":{"type":"array","items":{"$ref":"#/components/schemas/InnovationRankingItemDTO"}}}},"InnovationRankingItemDTO":{"type":"object","properties":{"id":{"type":"string"},"totalIdeas":{"type":"integer","format":"int32"},"totalAcceptedIdeas":{"type":"integer","format":"int32"}}}}},"paths":{"/api/v1/company/stats/innovation/ranking":{"get":{"tags":["innovation-stats-resource"],"operationId":"getInnovationRankingStats","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"hierarchyId","in":"query","required":false,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"type":"string"}},{"name":"groupId","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["USER","HIERARCHY"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InnovationRankingResultDTO"}}}}}}}}}
```
