> 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/recognition-stats-resource.md).

# Recognition Stats Resource

## GET /api/v1/company/stats/recognition

>

```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":{"RecognitionAggregatedResultDTO":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"total":{"type":"integer","format":"int32"},"results":{"type":"array","items":{"$ref":"#/components/schemas/RecognitionAggregatedItemDTO"},"uniqueItems":true}}},"RecognitionAggregatedItemDTO":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/RecognitionValueDTO"},"count":{"type":"integer","format":"int32"}}},"RecognitionValueDTO":{"type":"object","properties":{"id":{"type":"string"},"name":{"$ref":"#/components/schemas/MultiLanguage"},"iconImagePath":{"type":"string"}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]}}},"paths":{"/api/v1/company/stats/recognition":{"get":{"tags":["recognition-stats-resource"],"operationId":"getRecognitionStats","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":"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}},{"name":"valueIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecognitionAggregatedResultDTO"}}}}}}}}}
```

## GET /api/v1/company/stats/recognition/ranking/target

>

```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":{"RecognitionRankingDTO":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"ranking":{"type":"array","items":{"$ref":"#/components/schemas/RecognitionRankingItemDTO"}}}},"RecognitionRankingItemDTO":{"type":"object","properties":{"id":{"type":"string"},"count":{"type":"integer","format":"int32"},"name":{"type":"string"},"sourceType":{"$ref":"#/components/schemas/RecognitionSourceType"},"targetType":{"$ref":"#/components/schemas/FeedbackTargetType"}}},"RecognitionSourceType":{"type":"string","description":"Recognition source type","enum":["USER","AREA"]},"FeedbackTargetType":{"type":"string","description":"Feedback target type","enum":["EMPLOYEE","MANAGER","HIERARCHY","FREE"]}}},"paths":{"/api/v1/company/stats/recognition/ranking/target":{"get":{"tags":["recognition-stats-resource"],"operationId":"getRecognitionTargetRankingStats","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}},{"name":"valueIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecognitionRankingDTO"}}}}}}}}}
```

## GET /api/v1/company/stats/recognition/ranking/source

>

```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":{"RecognitionRankingDTO":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"ranking":{"type":"array","items":{"$ref":"#/components/schemas/RecognitionRankingItemDTO"}}}},"RecognitionRankingItemDTO":{"type":"object","properties":{"id":{"type":"string"},"count":{"type":"integer","format":"int32"},"name":{"type":"string"},"sourceType":{"$ref":"#/components/schemas/RecognitionSourceType"},"targetType":{"$ref":"#/components/schemas/FeedbackTargetType"}}},"RecognitionSourceType":{"type":"string","description":"Recognition source type","enum":["USER","AREA"]},"FeedbackTargetType":{"type":"string","description":"Feedback target type","enum":["EMPLOYEE","MANAGER","HIERARCHY","FREE"]}}},"paths":{"/api/v1/company/stats/recognition/ranking/source":{"get":{"tags":["recognition-stats-resource"],"operationId":"getRecognitionSourceRankingStats","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}},{"name":"valueIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecognitionRankingDTO"}}}}}}}}}
```
