List questions | Middesk

curl https://api.middesk.com/v1/agent/questions \
     -H "Authorization: Bearer <token>"

{
  "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."
          }
        ]
      },
      "components": [
        "year",
        "quarter"
      ],
      "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,
      "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": "!="
          }
        ]
      ],
      "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,
      "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

List Questions Request Bad Request Error

422

List Questions Request Unprocessable Entity Error