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,
      "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,
      "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.

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.

​Endpoint

​Query Parameters

​Example Request

​Example Response

​Response Fields

Endpoint

Query Parameters

Example Request

Example Response

Response Fields