---
title: "List a questionnaire's answer requests"
method: GET
path: "/api/questionnaires/{id}/requests"
tags: ["Questionnaire request"]
---

# List a questionnaire's answer requests

`GET /api/questionnaires/{id}/requests`

Paginated, filterable, sortable list of the answer requests on one questionnaire — one row per invited company, carrying that request's status and answer statistics alongside profile data for the supplier and answering companies. The questionnaire must belong to the calling company; Retraced admins may read any. `facilityProcesses` comes back as a comma-separated string of ids, not an array.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `count` integer
- `sort` string
- `filter` string

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
    - `pagination` object
      - `page` number, required — Current page number (1-based).
      - `limit` number, required — Page size used for this response. Endpoint defaults vary — see each endpoint's limit parameter.
      - `total` number, required — Total number of records across all pages.
      - `totalPages` number, required — Total number of pages. Iterate until page reaches totalPages.
  - `data` object[], required
    - `id` string, required
    - `questionnaireId` string, required
    - `forCompanyId` string, required
    - `onBehalfOfCompanyId` string, required
    - `status` 'OPEN' | 'IN_REVIEW' | 'COMPLETED' | 'REQUEST_CHANGES' | 'DELETED', required
    - `supplierName` string
    - `answeredByName` string
    - `supplierConnected` boolean
    - `answeredByConnected` boolean
    - `updatedByUserName` string
    - `updatedByCompanyName` string
    - `facilityProcesses` string
    - `collaborationStatus` string
    - `country` string
    - `internalCompanyCode` string
    - `notes` string
    - `dueDate` string
    - `createdAt` string
    - `updatedAt` string
    - `lastReminded` string
    - `supplyChainTier` string[]
    - `relationshipType` union
      - object[]
        - `id` string, required
      - object
    - `agents` union
      - object[]
        - `id` string, required
      - string
    - `vendors` union
      - object[]
        - `id` string, required
      - string
    - `statistics` object
      - `totalApprovedResponses` number
      - `totalInReviewResponses` number
      - `totalDeniedResponses` number
      - `totalMissingResponses` number
      - `totalResponses` number
      - `totalQuestions` number
      - `totalComments` number
      - `approvedResponsesPercentage` number
      - `inReviewResponsesPercentage` number
      - `deniedResponsesPercentage` number
      - `missingResponsesPercentage` number
      - `responsesPercentage` number

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response

## Changes

- **2026-08-26** `b815f1f4e5bf` — 5 warning, 16 info
  - added the new `COMPLETED` enum value to the `data/items/status` response property for the response status `200`
  - added the new `DELETED` enum value to the `data/items/status` response property for the response status `200`
  - added the new `IN_REVIEW` enum value to the `data/items/status` response property for the response status `200`
  - added the new `OPEN` enum value to the `data/items/status` response property for the response status `200`
  - …17 more
- **2026-08-24** `60f934498ae2` — 1 breaking, 9 info
  - removed the required property `meta` from the response with the `200` status
  - added the optional property `expected` to the response with the `400` status
  - added the optional property `expected` to the response with the `401` status
  - added the optional property `expected` to the response with the `403` status
  - …6 more
- **2026-08-13** `8b48cb95655b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/questionnaires/:id/requests/get.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/edebda781916/schema)