---
title: "List questions"
method: GET
path: "/v1/agent/questions"
tags: ["questions"]
---

# List questions

`GET /v1/agent/questions`

Retrieve the set of dynamic questions required for a registration in a given state or local jurisdiction. The questions returned depend on the jurisdiction and registration type.

## Query parameters

- `state` string
- `states[]` string
- `jurisdiction_slugs[]` string
- `categories[]` 'state_tax_withholdings' | 'state_unemployment_insurance' | 'foreign_qualification' | 'annual_filing'

## Headers

- `Authorization` string, required

## Response `200`

questions list

- TypeQuestionsListQuestionsResponse
  - `data` union
    - TypeAgentQuestion[]
      - `key` string, required — Unique identifier for the question. Use this key when submitting answers.
      - `label` string, required — Human-readable display text for the question.
      - `type` 'text' | 'number' | 'date' | 'date_part' | 'select' | 'multiselect' | 'boolean' | 'address' | 'document' | 'account' | 'textarea' | 'phone' | 'officers_table' | 'string', required — Input type for the question.
      - `categories` string[], nullable — Registration types this question applies to.
      - `optional` boolean, nullable — Whether the question is optional.
      - `validation` TypeAgentQuestionValidation — Validation rules for the answer.
        - `date` TypeAgentQuestionValidationDateItem[] — Array of date-based validation rules.
          - `before` boolean, required — If true, the answer must be before the reference date.
          - `date` string, nullable — ISO 8601 timestamp used as the reference date.
          - `key` string — Key of another question whose answer is used as the reference date.
          - `message` string — Error message displayed when validation fails.
        - `format` string[] — Array of accepted format patterns for text input.
        - `min_value` integer — Minimum accepted numeric value.
      - `company_dependencies` array[], nullable — Conditions under which this question is shown, based on company properties. Each element is an array of conditions that are ANDed together; the outer array elements are ORed. For example, [[{field: A}, {field: B}], [{field: C}]] means (A AND B) OR C.
        - TypeAgentQuestionCompanyDependenciesItemItem[]
          - `field` string, required — The company property to evaluate (e.g., entity_type, non_profit, formation_state, household).
          - `value` union, required — The value to compare against.
            - string
            - string[]
          - `comparator` '==' | '!=' | '>' | '<' | '>=' | '<=' | 'starts_with' | 'len_gt' | 'missing_suffix' | 'has_special_chars' — Comparison operator. Defaults to == (equality). For array values, membership is checked.
      - `options` string[], nullable — Available options for select and multiselect type questions.
      - `sublabel` string, nullable — Additional descriptive text displayed below the question label.
      - `components` string[], nullable — For date_part type questions, specifies which date components to display.
      - `question_dependency` TypeAgentQuestionQuestionDependency — Defines a dependency on another question's answer. The question is only shown when the dependency condition is met.
        - `key` string, required — The key of the question this depends on.
        - `value` union, required — The value(s) the dependent question's answer must match.
          - string
          - string[]
        - `comparator` '==' | '!=' | '>' | '<' | '>=' | '<=' | 'len_gt' — Comparison operator. Defaults to == (equality).
      - `warning` TypeAgentQuestionWarning — Warning rules for the question.
        - `date` TypeAgentQuestionWarningDateItem[] — Array of date-based warning rules.
          - `before` boolean, required — If true, warn when the answer is before the reference date.
          - `date` string, nullable — ISO 8601 timestamp used as the reference date.
          - `key` string — Key of another question whose answer is used as the reference date.
          - `offset_days` integer — Number of days to offset from the reference date.
          - `message` string, required — Warning message displayed to the user.
      - `api_only` boolean, nullable — If true, this question is only used for API submissions.
      - `tooltip` string, nullable — Help text displayed in a tooltip alongside the question.
      - `jurisdiction_slugs` string[], nullable — Jurisdiction slugs this question applies to.
      - `updated_at` string, nullable — Date the question was last updated (YYYY-MM-DD).
      - `ai_validated` boolean, nullable — Whether the question answer is validated by AI.
    - TypeQuestionsListQuestionsResponseDataOneItem[]
      - `state` string
      - `questions` TypeAgentQuestion[]
        - `key` string, required — Unique identifier for the question. Use this key when submitting answers.
        - `label` string, required — Human-readable display text for the question.
        - `type` 'text' | 'number' | 'date' | 'date_part' | 'select' | 'multiselect' | 'boolean' | 'address' | 'document' | 'account' | 'textarea' | 'phone' | 'officers_table' | 'string', required — Input type for the question.
        - `categories` string[], nullable — Registration types this question applies to.
        - `optional` boolean, nullable — Whether the question is optional.
        - `validation` TypeAgentQuestionValidation — Validation rules for the answer.
          - `date` TypeAgentQuestionValidationDateItem[] — Array of date-based validation rules.
            - `before` boolean, required — If true, the answer must be before the reference date.
            - `date` string, nullable — ISO 8601 timestamp used as the reference date.
            - `key` string — Key of another question whose answer is used as the reference date.
            - `message` string — Error message displayed when validation fails.
          - `format` string[] — Array of accepted format patterns for text input.
          - `min_value` integer — Minimum accepted numeric value.
        - `company_dependencies` array[], nullable — Conditions under which this question is shown, based on company properties. Each element is an array of conditions that are ANDed together; the outer array elements are ORed. For example, [[{field: A}, {field: B}], [{field: C}]] means (A AND B) OR C.
          - TypeAgentQuestionCompanyDependenciesItemItem[]
            - `field` string, required — The company property to evaluate (e.g., entity_type, non_profit, formation_state, household).
            - `value` union, required — The value to compare against.
              - …
            - `comparator` '==' | '!=' | '>' | '<' | '>=' | '<=' | 'starts_with' | 'len_gt' | 'missing_suffix' | 'has_special_chars' — Comparison operator. Defaults to == (equality). For array values, membership is checked.
        - `options` string[], nullable — Available options for select and multiselect type questions.
        - `sublabel` string, nullable — Additional descriptive text displayed below the question label.
        - `components` string[], nullable — For date_part type questions, specifies which date components to display.
        - `question_dependency` TypeAgentQuestionQuestionDependency — Defines a dependency on another question's answer. The question is only shown when the dependency condition is met.
          - `key` string, required — The key of the question this depends on.
          - `value` union, required — The value(s) the dependent question's answer must match.
            - string
            - string[]
          - `comparator` '==' | '!=' | '>' | '<' | '>=' | '<=' | 'len_gt' — Comparison operator. Defaults to == (equality).
        - `warning` TypeAgentQuestionWarning — Warning rules for the question.
          - `date` TypeAgentQuestionWarningDateItem[] — Array of date-based warning rules.
            - `before` boolean, required — If true, warn when the answer is before the reference date.
            - `date` string, nullable — ISO 8601 timestamp used as the reference date.
            - `key` string — Key of another question whose answer is used as the reference date.
            - `offset_days` integer — Number of days to offset from the reference date.
            - `message` string, required — Warning message displayed to the user.
        - `api_only` boolean, nullable — If true, this question is only used for API submissions.
        - `tooltip` string, nullable — Help text displayed in a tooltip alongside the question.
        - `jurisdiction_slugs` string[], nullable — Jurisdiction slugs this question applies to.
        - `updated_at` string, nullable — Date the question was last updated (YYYY-MM-DD).
        - `ai_validated` boolean, nullable — Whether the question answer is validated by AI.
    - object

## Other responses

- `400` — bad request

---

[API](https://skmtc.net/middesk/apis/middesk-api.md) · [All operations](https://skmtc.net/middesk/apis/middesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/middesk/middesk-api/revisions/f849b82a42e1/schema)