# Honestly - [Using Honestly (141 pages)](https://help.honestly.com/_llms/en/using-honestly.md): Documentation for Using Honestly. ## Developers ### Developer docs #### Get Started - [Honestly Export API: What You Can Export](https://help.honestly.com/developers/introduction.md): The Honestly Export API provides programmatic access to your survey results, employee records, question data, and aggregated engagement scores. - [Honestly Export API: Authentication and API Keys](https://help.honestly.com/developers/authentication.md): Honestly uses API key authentication. Include your X-Api-Key header on every request to the Export API. Learn how to get and use your key. - [Honestly Export API: Make Your First API Call](https://help.honestly.com/developers/quickstart.md): Learn how to authenticate and make your first call to the Honestly Export API in under 5 minutes. Export surveys, employees, and scores. #### Core Concepts - [How to Paginate Results in the Honestly Export API](https://help.honestly.com/developers/concepts/pagination.md): The Honestly Export API uses offset-based pagination. Use limit and offset query parameters to page through large result sets efficiently. - [How to Handle API Errors in the Honestly Export API](https://help.honestly.com/developers/concepts/error-handling.md): Learn how the Honestly Export API signals failures with HTTP status codes and a structured JSON error object you can parse in your integration. - [API Versioning and Backward Compatibility Guarantees](https://help.honestly.com/developers/concepts/versioning.md): Honestly's Export API follows semantic versioning. Learn how version increments work and what backward compatibility guarantees you can rely on. #### API Reference - [Honestly Export API v1.3.0 — Full Reference Guide](https://help.honestly.com/developers/api-reference/overview.md): Complete reference for the Honestly Export API v1.3.0. Base URL, authentication, pagination, and links to all available endpoints. - [GET /v1/surveys — List and Filter Surveys by Status](https://help.honestly.com/developers/api-reference/surveys.md): Retrieve a paginated list of surveys from your Honestly account. Filter by creation date and archived status, and use total_count to paginate through all results. - [GET /v1/questions — List and Filter Survey Questions](https://help.honestly.com/developers/api-reference/questions.md): Retrieve all questions from your Honestly surveys, including their translated name, type, answer options, and deleted status. Supports offset pagination. - [GET /v1/employees — Export and List Employee Records](https://help.honestly.com/developers/api-reference/employees.md): Retrieve all employee records from your Honestly account, including roles, custom attributes, and deleted status. Cross-reference with your response exports. - [GET /v1/survey_assignments — List Survey Assignments](https://help.honestly.com/developers/api-reference/survey-assignments.md): Retrieve all historical survey-to-employee assignments from Honestly. See which employees were assigned to which surveys, and when they were assigned or unassigned. - [GET /v1/scores — Retrieve Aggregated Engagement Scores](https://help.honestly.com/developers/api-reference/scores.md): Retrieve a single aggregated, anonymity-protected engagement score for a set of questions over a time window. Filter by employee attribute, and read the score distribution and participation rates. Available as of Export API v1.2.0. - [GET /v1/initiatives — List Initiatives (Action Items)](https://help.honestly.com/developers/api-reference/initiatives.md): Retrieve a paginated list of your account's initiatives — the action items derived from survey results — including their status, linked survey and questions, assignee, and reminder settings. Available as of Export API v1.3.0. - [GET /v1/attributes — List Employee Attributes and Their Options](https://help.honestly.com/developers/api-reference/attributes.md): List the employee attributes released for API use and their options, to filter and group engagement scores by cohort. Planned for Export API v1.4.0. - [GET /v1/survey_cycles — List the Cycles of a Recurring Survey](https://help.honestly.com/developers/api-reference/survey-cycles.md): List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0. - [GET /v1/text_responses — Export Free-Text Survey Answers](https://help.honestly.com/developers/api-reference/text-responses.md): Export the free-text answers to open questions with their topics and per-topic sentiment, filtered by survey or survey cycle. Anonymity-protected, with optional PII masking. Planned for Export API v1.4.0. - [POST /v1/employees/imports — Import Employees](https://help.honestly.com/developers/api-reference/employee-import.md): Push your full employee list to Honestly over the REST API. Replaces CSV over SFTP. Learn the snapshot model, the omitted/null/value rule, and the deletion threshold. > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [English / Using Honestly (141 pages)](https://help.honestly.com/_llms/en/using-honestly.md): Documentation for English / Using Honestly. - [German (159 pages)](https://help.honestly.com/_llms/de.md): Documentation for German. - [German / Using Honestly (142 pages)](https://help.honestly.com/_llms/de/using-honestly.md): Documentation for German / Using Honestly.