---
title: "List inbound questionnaires"
method: GET
path: "/trust_exchange/questionnaire/list"
tags: ["trust_exchange"]
---

# List inbound questionnaires

`GET /trust_exchange/questionnaire/list`

## Request

- Base URL: `https://cyber-risk.upguard.com/api/public`
- URL: `https://cyber-risk.upguard.com/api/public/trust_exchange/questionnaire/list`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/docs/trust_exchange/questionnaire/list/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of inbound security questionnaires that are available to all users in the organisation.
This includes all questionnaires where the "Allow others in my account to reuse answers" setting is enabled.

Required API key permissions: `TrustExchange` (select when creating API key in Account Settings)

## Query parameters

- `page_size` integer
- `page_token` string
- `sort_by` string
- `sort_dir` string
- `filter_text` string

## Response `200`

List of inbound questionnaires.

- QuestionnaireListResponse
  - `next_page_token` string: Pagination token for fetching the next page. Empty when there are no more results.
  - `questionnaires` InboundQuestionnaire[]: The list of inbound questionnaires shared with the organization.
    - `date_completed` string, date-time: The date the questionnaire was completed.
    - `date_created` string, date-time: The date the questionnaire was created.
    - `date_due` string, date-time: The due date for the questionnaire.
    - `date_submitted` string, date-time: The date the questionnaire was submitted.
    - `id` integer: The unique identifier of the questionnaire.
    - `name` string: The name of the questionnaire.
    - `num_answers` integer: The number of questions that have been answered.
    - `num_questions` integer: The total number of questions in the questionnaire.
    - `questionnaire_type_name` string: The name of the questionnaire type.
    - `recipients` InboundQuestionnaireRecipient[]: The list of recipients assigned to the questionnaire.
      - `email` string: The email address of the recipient.
      - `name` string: The name of the recipient.
    - `sender_org_name` string: The name of the organization that sent the questionnaire.
    - `status` string: The current status of the questionnaire.

## Other responses

- `403`: Account does not have access to requested entities
- `429`: Too many requests have been made to this endpoint.
- `500`: An internal system error occurred

## Changes

- **2026-11-07** `d044bf6dc61e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/changes/trust_exchange/questionnaire/list/get.md)

---

[API](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api.md) - [All operations](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/revisions/d044bf6dc61e?raw)