GET /v1/initiatives — List Initiatives (Action Items)

The /v1/initiatives endpoint returns a paginated list of your account’s initiatives — the action items teams derive from survey results. Each entry contains the full data of an initiative, so you can sync action plans and their progress into your warehouse. An initiative is identified by its uuid. The surveys, questions, and employees it references are exposed by the same integer IDs returned by the /v1/surveys, /v1/questions, and /v1/employees endpoints, so you can cross-reference them. Initiatives are returned ordered by created_at descending.

Endpoint

GET https://api.honestly.com/v1/initiatives

Query Parameters

integer

Maximum number of initiatives to return per page. Accepts values from 0 to 1000. Defaults to 100.

integer

Number of initiatives to skip before returning results. Defaults to 0.

string

Return only initiatives with this status. One of draft, defined, in_progress, or completed. Omit to return initiatives of any status.

Example Request

curl -X GET "https://api.honestly.com/v1/initiatives?limit=100&offset=0&status=in_progress" \
  -H "X-Api-Key: YOUR_SECRET_API_KEY"

Example Response

{
  "total_count": 1,
  "initiatives": [
    {
      "uuid": "8f1d2c3a-4b5e-6789-90ab-cdef01234567",
      "title": "Improve onboarding for new joiners",
      "status": "in_progress",
      "survey": {
        "id": 51,
        "name": {
          "en": "Engagement Pulse",
          "de": "Engagement Pulse"
        }
      },
      "questions": [
        {
          "id": 121,
          "name": {
            "en": "How clear was your onboarding?",
            "de": "Wie klar war Ihr Onboarding?"
          }
        }
      ],
      "assignee": {
        "employee_id": 23,
        "firstname": "Jane",
        "lastname": "Doe"
      },
      "creator": {
        "employee_id": 7,
        "firstname": "John",
        "lastname": "Smith"
      },
      "notes": "Kick-off with the People team in Q2.",
      "completion_date": "2026-06-30T00:00:00Z",
      "created_at": "2026-04-01T09:12:00Z",
      "updated_at": "2026-05-02T14:03:00Z",
      "is_private": false,
      "reminder_settings": ["three_days_before"],
      "notification_settings": ["on_create", "on_update"]
    }
  ]
}

Response Fields

integer

Total number of initiatives matching the query. Use this value to calculate how many pages to fetch when paginating.

array

List of initiative objects.

Show initiative object fields

string

The unique identifier of the initiative.

string

The title of the initiative.

string

The current state of the initiative. One of draft, defined, in_progress, or completed.

object | null

The survey the initiative is linked to, or null when it is not linked to a survey.

Show survey reference fields

integer

Survey ID, matching the IDs returned by the /v1/surveys endpoint.

object

The translated survey name, keyed by ISO 639-1 language code (e.g. { "en": "…", "de": "…" }).

array

The questions the initiative is linked to.

Show question reference fields

integer

Question ID, matching the IDs returned by the /v1/questions endpoint.

object

The translated question name, keyed by ISO 639-1 language code.

object | null

The employee the initiative is assigned to. null when the initiative is unassigned or the assignee was deleted.

Show employee reference fields

integer

Employee ID, matching the IDs returned by the /v1/employees endpoint.

string | null

The employee’s first name.

string | null

The employee’s last name.

object | null

The employee who created the initiative, using the same fields as assignee. null when the creator was deleted.

string

Free-text notes attached to the initiative. An empty string when no notes were set.

string | null

RFC 3339 datetime of the target completion date. null when no completion date is set.

string

RFC 3339 datetime indicating when the initiative was created.

string | null

RFC 3339 datetime indicating when the initiative was last updated. null when it was never updated after creation.

boolean

Whether the initiative is marked as private.

array of strings

The configured reminders for the initiative’s completion date. Each value is one of same_day or three_days_before.

array of strings

The events for which the assignee is notified. Each value is one of on_create or on_update.

Use total_count to calculate how many pages to fetch. See Pagination for a complete walkthrough.

​Endpoint

​Query Parameters

​Example Request

​Example Response

​Response Fields

Endpoint

Query Parameters

Example Request

Example Response

Response Fields