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.

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."
      }
    ]
  }
}

Versioning Surveys

​Base URL

​Authentication

​Available Endpoints