> ## Documentation Index
> Fetch the complete documentation index at: https://help.honestly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Honestly Export API v1.3.0 — Full Reference Guide

> Complete reference for the Honestly Export API v1.3.0. Base URL, authentication, pagination, and links to all available endpoints.

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

```text theme={null}
https://api.honestly.com
```

## Authentication

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

```text theme={null}
X-Api-Key: YOUR_SECRET_API_KEY
```

For full details on generating and managing API keys, see the [Authentication](/developers/authentication) guide.

## Available Endpoints

<CardGroup cols={2}>
  <Card title="Surveys" icon="clipboard-list" href="/developers/api-reference/surveys">
    List and filter surveys in your Honestly account.
  </Card>

  <Card title="Questions" icon="circle-question" href="/developers/api-reference/questions">
    Retrieve survey questions and their metadata.
  </Card>

  <Card title="Employees" icon="users" href="/developers/api-reference/employees">
    Access employee records and profile data.
  </Card>

  <Card title="Survey Assignments" icon="user-check" href="/developers/api-reference/survey-assignments">
    Query which employees are assigned to which surveys.
  </Card>

  <Card title="Scores" icon="chart-bar" href="/developers/api-reference/scores">
    Export aggregated engagement scores and metrics.
  </Card>

  <Card title="Initiatives" icon="list-check" href="/developers/api-reference/initiatives">
    List initiatives (action items) derived from survey results.
  </Card>
</CardGroup>

## Common Conventions

**Date-time format** — All date-time parameters use [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) 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:

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