Honestly Export API v1.3.0 — Full Reference Guide

This reference covers all endpoints available in the Honestly Export API v1.3.0. Use it alongside the core concepts guides for authentication, pagination, and error handling.

Base URL

https://api.honestly.com

Authentication

Include your secret API key as an X-Api-Key header on every request:

X-Api-Key: YOUR_SECRET_API_KEY

For full details on generating and managing API keys, see the Authentication guide.

Available Endpoints

Surveys

List and filter surveys in your Honestly account.

Questions

Retrieve survey questions and their metadata.

Employees

Access employee records and profile data.

Survey Assignments

Query which employees are assigned to which surveys.

Scores

Export aggregated engagement scores and metrics.

Initiatives

List initiatives (action items) derived from survey results.

Planned for v1.4.0

These endpoints are documented so you can plan your integration. They are not yet available on api.honestly.com — see Versioning for the release.

Attributes

List employee attributes and their options, to filter and group scores by cohort.

Text Responses

Export anonymity-protected free-text answers with their topics and per-topic sentiment.

Survey Cycles

List the open and closed cycles of a recurring survey, with their exact boundaries.

Employee Import

Push your full employee list to Honestly. The only write endpoint, and it needs its own key.

Common Conventions

Date-time format — All date-time parameters use RFC 3339 format (e.g., 2017-07-21T17:32:28Z). When passing date-time values as GET query parameters, make sure to URL-encode them. Pagination — All list endpoints support limit and offset query parameters and include a total_count field in the response body. Use total_count to determine how many total records exist and calculate the number of pages to fetch. Error responses — All error responses share a consistent envelope structure:

{
  "error": {
    "code": 5003,
    "message": "A human-readable description of the error.",
    "errors": [
      {
        "field": "field_name",
        "message": "Validation detail for this field."
      }
    ]
  }
}

​Base URL

​Authentication

​Available Endpoints