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

# List a company's answer requests

`GET /api/questionnaires/requests`

Paginated, filterable, sortable list of answer requests scoped to the calling company. Without `companyId` it returns the requests the caller received — their questionnaire inbox. With `companyId` it returns the requests the caller sent to that one company, limited to questionnaires the caller owns. Archived questionnaires and deleted requests are excluded from both. A request is only listed when the caller holds an `ABOUT` profile for both the requesting company and the company the request is about.

## Query parameters

- `companyId` string
- `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
    - `name` string, required
    - `forCompanyId` string, required
    - `onBehalfOfCompanyId` string, required
    - `requestedBy` string
    - `about` string
    - `status` 'OPEN' | 'IN_REVIEW' | 'COMPLETED' | 'REQUEST_CHANGES' | 'DELETED', required
    - `updatedByUserName` string
    - `updatedByCompanyName` string
    - `supplierConnected` boolean
    - `answeredByConnected` boolean
    - `dueDate` string
    - `createdAt` string
    - `updatedAt` string
    - `lastReminded` 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

> 21 revisions in range; 1 not diffed.

- **2026-08-26** `b815f1f4e5bf` — 5 warning, 14 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`
  - …15 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-17** `853f4e9f5103` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/questionnaires/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/1df37791a1bb/schema)