# Get segment questionnaires info

This endpoint will return info about the latest questionnaires for each template sent to a specific segment.

Endpoint: GET /v2/suppliers/{supplierId}/segment/{segmentId}/questionnaires
Version: 2
Security: bearer

## Path parameters:

  - `supplierId` (string, required)
    Id of the supplier

  - `segmentId` (string, required)
    Id of the segment

## Query parameters:

  - `limit` (number)
    Number of records to return in the response

  - `sortBy` (string)
    Name of the field to sort by
    Enum: "questionnaire_id", "template_name", "completion_rate", "status_update_date", "created_by", "status", "score", "ttl", "weight", "questionnaire_submit_date", "questionnaire_sent_date"

  - `sortDirection` (string)
    The direction of the field sort specified by sort_by
    Enum: "ASC", "asc", "1", "DESC", "desc", "-1"

  - `next_token` (string)
    Token received from a previous request to obtain the next chunk of data

  - `questionnaire_type` (string)
    Enum: "external", "internal", "both"

  - `fields` (string, required)
    Enum: "questionnaire_id", "template_name", "completion_rate", "status_update_date", "created_by", "status", "score", "ttl", "weight", "questionnaire_submit_date", "questionnaire_sent_date"

  - `template_names` (array)

## Response 200 fields (application/json):

  - `questionnaire_id` (string, required)
    Id of the questionnaire

  - `template_name` (string, required)
    Name of the template

  - `completion_rate` (number, required)
    Float from 0 to 1

  - `status` (string, required)
    Enum: "SENT", "IN_PROGRESS", "DONE", "CANCELED", "EXPIRED", "IN_REVIEW", "ARCHIVED"

  - `ttl` (string,null, required)

  - `questionnaire_type` (string, required)
    Enum: "external", "internal", "both"

  - `status_update_date` (string, required)

  - `created_by` (string, required)

  - `score` (number,null, required)

  - `weight` (number, required)

  - `questionnaire_submit_date` (string,null, required)

  - `questionnaire_sent_date` (string, required)


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields