GET /v1/questions — List and Filter Survey Questions

The /v1/questions endpoint returns a paginated list of all survey questions in your Honestly account. Use it to understand the structure of your surveys before exporting responses or scores.

Endpoint

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

Query Parameters

integer

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

integer

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

Example Request

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

Example Response

{
  "total_count": 2,
  "questions": [
    {
      "id": 23,
      "name": {
        "en": "How satisfied are you with your workplace?",
        "de": "Sind Sie zufrieden mit Ihrem Arbeitsplatz?"
      },
      "type": "ranked_select",
      "is_deleted": false,
      "dimension": "Leadership",
      "answer_options": [
        {
          "id": 12,
          "name": { "en": "Not satisfied at all", "de": "Gar nicht zufrieden" },
          "value": 0,
          "is_maximum": false,
          "is_minimum": true
        },
        {
          "id": 13,
          "name": { "en": "Very satisfied", "de": "Sehr zufrieden" },
          "value": 5,
          "is_maximum": true,
          "is_minimum": false
        }
      ]
    },
    {
      "id": 24,
      "name": {
        "en": "What could we improve about our meetings?",
        "de": "Was können wir an unseren Meetings verbessern?"
      },
      "type": "textfield",
      "is_deleted": true,
      "dimension": null,
      "answer_options": []
    }
  ]
}

Response Fields

integer

Total number of questions matching the query.

array

List of question objects.

Show question object fields

integer

Unique identifier for the question.

object

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

string

The question type. One of stars, textfield, single_select, multiple_select, ranked_select, smiley_faces, or nps. Use the type to determine how to calculate a score.

boolean

true if the question has been deleted from the survey.

string | null

Planned for v1.4.0. Title of the dimension this question belongs to, for example "Leadership". null when the question is not mapped to a dimension.A question belongs to at most one dimension, so this is a plain string rather than an object or a list. Group questions by matching on this value.

array

Always present. For question types with a fixed set of options (single_select, multiple_select, ranked_select, smiley_faces, nps, stars) it lists every possible option; for free-text questions (textfield) it is an empty array.

Show answer option fields

integer

Unique identifier for the answer option.

object

The translated option label, keyed by ISO 639-1 language code.

number

Numeric value that can be used to calculate a score.

boolean

true when this option is the best possible answer in the ordered set.

boolean

true when this option is the worst possible answer in the ordered set.

The type field uses an extensible enum — new question types may be added as Honestly introduces new features. Make sure your code handles unknown values gracefully.

The dimension field is planned for v1.4.0 and is not yet returned by api.honestly.com. It is documented here so you can plan your integration. Watch Versioning for the release.

To score a whole dimension, collect the IDs of every question whose dimension matches that title and pass them together as question_ids to /v1/scores — the endpoint aggregates them into one score.

​Endpoint

​Query Parameters

​Example Request

​Example Response

​Response Fields

Endpoint

Query Parameters

Example Request

Example Response

Response Fields