List questions | Middesk

import requests
url = "https://api.middesk.com/v1/agent/questions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "key": "ca_payroll_date",
      "label": "Enter the calendar year and quarter you will run / did run your first payroll in California",
      "type": "date_part",
      "categories": [
        "state_unemployment_insurance",
        "state_tax_withholdings"
      ],
      "optional": true,
      "validation": {
        "date": [
          {
            "before": false,
            "date": "2025-03-25T00:00:00.000Z",
            "message": "We cannot accept your payroll date answer as it is more than 1 year ago."
          }
        ]
      },
      "company_dependencies": [
        [
          {
            "field": "field",
            "value": "value"
          }
        ]
      ],
      "options": [
        "options"
      ],
      "sublabel": "sublabel",
      "components": [
        "year",
        "quarter"
      ],
      "question_dependency": {
        "key": "key",
        "value": "value"
      },
      "warning": {
        "date": [
          {
            "before": true,
            "date": "2025-09-25T00:00:00.000Z",
            "message": "Please double check your payroll date answer as it is more than 6 months ago."
          }
        ]
      },
      "api_only": true,
      "tooltip": "tooltip",
      "jurisdiction_slugs": [
        "california_state_unemployment_tax",
        "california_state_tax_withholdings"
      ],
      "updated_at": "2026-03-02",
      "ai_validated": false
    },
    {
      "key": "ca_sos_id_number",
      "label": "What is your California Secretary of State Identification Number?",
      "type": "text",
      "categories": [
        "state_unemployment_insurance",
        "state_tax_withholdings"
      ],
      "optional": true,
      "validation": {
        "format": [
          "C#######",
          "BXXXXXXXXXXX",
          "BXXXXXXXXXXXX",
          "############",
          "#######"
        ]
      },
      "company_dependencies": [
        [
          {
            "field": "formation_state",
            "value": "CA",
            "comparator": "!="
          },
          {
            "field": "entity_type",
            "value": "sole_proprietorship",
            "comparator": "!="
          }
        ]
      ],
      "options": [
        "options"
      ],
      "sublabel": "This number can be found on your Secretary of State filing documentation or online on the California Secretary of State website",
      "components": [
        "components"
      ],
      "question_dependency": {
        "key": "ca_sos_registered",
        "value": "true"
      },
      "api_only": true,
      "tooltip": "tooltip",
      "jurisdiction_slugs": [
        "california_state_unemployment_tax",
        "california_state_tax_withholdings"
      ],
      "updated_at": "2025-12-04",
      "ai_validated": false
    }
  ]
}

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

statestringOptional

Two-letter US state abbreviation (e.g., CA, NY). Required when jurisdiction_slugs is not provided and states is not used.

states[]stringOptional

Array of two-letter US state abbreviations. Used when fetching questions for multiple states.

jurisdiction_slugs[]stringOptional

Array of local jurisdiction slug identifiers. Used to fetch questions specific to local jurisdictions. Must be provided together with the state parameter.

categories[]enumOptional

Filter questions by registration type. Only applicable to state-level questions; omit for local jurisdiction questions.

Allowed values:

Response

questions list

datalist of objects or map from strings to lists of objects

Errors

400

Get V1agent Questions Request Bad Request Error

422

Get V1agent Questions Request Unprocessable Entity Error