Questionnaires API

Questionnaires are reusable DDQ (Due Diligence Questionnaire) templates containing structured questions. Each questionnaire serves as a blueprint for creating responses with specific entities.

Key Concepts

• Templates: Questionnaires are reusable templates, not assessments themselves
• Questions: Each questionnaire contains text-based questions with configurable types
• File Questions: Separate file upload requirements for documents and certificates
• Sections: Questions are organized into sections and subsections for structure

Common Use Cases

• Retrieve available questionnaires before creating a response
• Fetch question structure to build dynamic UI forms
• Understand required fields and question types for autofill
• Display questionnaire details to users

List Questionnaires

Retrieves a paginated list of all questionnaire templates in your tenant.

Query Parameters

Response

Returns paginated list with minimal questionnaire information. Each questionnaire includes:

• id - Questionnaire ID
• name - Questionnaire name
• description - Description text
• questionnaire_type - Type (ddq or rfi)
• question_count - Total number of text questions
• created_at - Creation timestamp

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Standard DDQ",
      "description": "Standard due diligence questionnaire",
      "questionnaire_type": "ddq",
      "question_count": 42,
      "created_at": "2026-01-15T10:30:00Z"
    },
    {
      "id": 2,
      "name": "Security Assessment",
      "description": "Information security assessment",
      "questionnaire_type": "ddq",
      "question_count": 28,
      "created_at": "2026-01-18T14:20:00Z"
    }
  ]
}

Get Questionnaire

Retrieves a specific questionnaire by ID, including all questions and file requirements.

Path Parameters

Response

Returns the full questionnaire object including:

• questions - Array of all text-based questions
• file_questions - Array of file upload requirements
• sections - Optional section structure (JSON)
• question_count - Total text questions
• response_count - Number of active responses using this template

List Questions

Retrieves all text-based questions for a questionnaire, ordered by section and number.

Response

Returns array of question objects ordered by section_number, sub_section_number, and number.

Questionnaire Object

The questionnaire object represents a reusable DDQ template with structured questions.

List View Attributes

Detail View Additional Fields

Question Object

Text-based questions within a questionnaire template.

Attributes

{
  "id": 123,
  "number": 1,
  "section": "Part 1",
  "section_number": 1,
  "sub_section": "Company Information",
  "sub_section_number": 1,
  "text": "What is your company's legal name?",
  "question_type": "text",
  "required": true,
  "exclude_from_autofill": false
}

{
  "id": 45,
  "document_type": "certificate_of_incorporation",
  "description": "Certificate of Incorporation",
  "required": true,
  "multiple": false
}

Question Types

KYC Genie supports four question types for text-based questions:

text (Free Text)

Open-ended text responses for descriptive answers.

{
  "question_type": "text",
  "text": "Describe your incident response procedures",
  "required": true
}

boolean (Yes/No)

Simple yes or no questions. Answer stored as "yes" or "no" text.

{
  "question_type": "boolean",
  "text": "Do you have ISO 27001 certification?",
  "required": true
}

yes_no_na (Yes/No/NA)

Yes/No with optional "Not Applicable" answer. Answer stored as "yes", "no", or "na".

{
  "question_type": "yes_no_na",
  "text": "Do you process credit card data?",
  "required": false
}

text_and_date (Text with Date)

Combined text response with associated date field.

{
  "question_type": "text_and_date",
  "text": "When did you last conduct a penetration test?",
  "required": true
}