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

# Reports Resource

## POST /api/v1/company/reports/timesheet/from/{from}/to/{to}

>

```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"}}},"paths":{"/api/v1/company/reports/timesheet/from/{from}/to/{to}":{"post":{"tags":["reports-resource"],"operationId":"sendTimesheetReport","parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"path","required":true,"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"}}}}}}
```

## POST /api/v1/company/reports/survey/{surveyId}/{reportType}

>

```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"}}},"paths":{"/api/v1/company/reports/survey/{surveyId}/{reportType}":{"post":{"tags":["reports-resource"],"operationId":"getSurveyReport","parameters":[{"name":"surveyId","in":"path","required":true,"schema":{"type":"string"}},{"name":"reportType","in":"path","required":true,"schema":{"type":"string","enum":["SUMMARY","RAW"]}},{"name":"roundId","in":"query","required":false,"schema":{"type":"string"}},{"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":"questionResults","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}}}}
```

## POST /api/v1/company/reports/score/{scoreId}/from/{from}/to/{to}

>

```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":{"GroupingType":{"type":"string","description":"Types of date grouping by segmentation","enum":["HIERARCHIES","GROUPS","CHARACTERISTICS","MANAGERS"]}}},"paths":{"/api/v1/company/reports/score/{scoreId}/from/{from}/to/{to}":{"post":{"tags":["reports-resource"],"operationId":"sendScoreReport","parameters":[{"name":"scoreId","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"groupingType","in":"query","required":false,"schema":{"$ref":"#/components/schemas/GroupingType"}},{"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"}}}}}}
```

## POST /api/v1/company/reports/question/from/{from}/to/{to}

>

```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"}}},"paths":{"/api/v1/company/reports/question/from/{from}/to/{to}":{"post":{"tags":["reports-resource"],"operationId":"getQuestionResultsReport","parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"questionId","in":"query","required":false,"schema":{"type":"string"}},{"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}}],"responses":{"200":{"description":"OK"}}}}}}
```

## POST /api/v1/company/reports/participants/from/{from}/to/{to}

>

```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":{"GroupingType":{"type":"string","description":"Types of date grouping by segmentation","enum":["HIERARCHIES","GROUPS","CHARACTERISTICS","MANAGERS"]}}},"paths":{"/api/v1/company/reports/participants/from/{from}/to/{to}":{"post":{"tags":["reports-resource"],"operationId":"getParticipationReport","parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"path","required":true,"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":"groupingType","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GroupingType"}}],"responses":{"200":{"description":"OK"}}}}}}
```

## POST /api/v1/company/reports/hi/from/{from}/to/{to}

>

```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"}}},"paths":{"/api/v1/company/reports/hi/from/{from}/to/{to}":{"post":{"tags":["reports-resource"],"operationId":"getHIReport","parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"path","required":true,"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}}],"responses":{"200":{"description":"OK"}}}}}}
```

## POST /api/v1/company/reports/global/{date}

>

```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"}}},"paths":{"/api/v1/company/reports/global/{date}":{"post":{"tags":["reports-resource"],"operationId":"sendGlobalResultsReport","parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"OK"}}}}}}
```

## POST /api/v1/company/reports/enps/from/{from}/to/{to}

>

```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":{"GroupingType":{"type":"string","description":"Types of date grouping by segmentation","enum":["HIERARCHIES","GROUPS","CHARACTERISTICS","MANAGERS"]}}},"paths":{"/api/v1/company/reports/enps/from/{from}/to/{to}":{"post":{"tags":["reports-resource"],"operationId":"sendENPSReport","parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"groupingType","in":"query","required":false,"schema":{"$ref":"#/components/schemas/GroupingType"}},{"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"}}}}}}
```

## POST /api/v1/company/reports/engagement/from/{from}/to/{to}/grouping/{groupingType}

>

```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":{"GroupingType":{"type":"string","description":"Types of date grouping by segmentation","enum":["HIERARCHIES","GROUPS","CHARACTERISTICS","MANAGERS"]}}},"paths":{"/api/v1/company/reports/engagement/from/{from}/to/{to}/grouping/{groupingType}":{"post":{"tags":["reports-resource"],"operationId":"sendEngagementReport","parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"groupingType","in":"path","required":true,"schema":{"$ref":"#/components/schemas/GroupingType"}},{"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}}],"responses":{"200":{"description":"OK"}}}}}}
```

## POST /api/v1/company/reports/employees

>

```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"}}},"paths":{"/api/v1/company/reports/employees":{"post":{"tags":["reports-resource"],"operationId":"exportEmployeesToExcel","responses":{"200":{"description":"OK"}}}}}}
```

## POST /api/v1/company/reports/activation/from/{from}/to/{to}

>

```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":{"GroupingType":{"type":"string","description":"Types of date grouping by segmentation","enum":["HIERARCHIES","GROUPS","CHARACTERISTICS","MANAGERS"]}}},"paths":{"/api/v1/company/reports/activation/from/{from}/to/{to}":{"post":{"tags":["reports-resource"],"operationId":"getActivationReport","parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"path","required":true,"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":"groupingType","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GroupingType"}}],"responses":{"200":{"description":"OK"}}}}}}
```
