thumbtack.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "filter_home_service_pros input",
  "description": "Refines a pro search using request-form answers. There is no saved search, so pass categoryID + zipCode + the requestForm (its requestFormID plus the full accumulated answer set) on each call.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "zipCode": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "US ZIP code to center the search (5 digits)."
    },
    "categoryID": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "The Thumbtack Category ID to fetch businesses for. Obtain from search_home_service_pros."
    },
    "requestForm": {
      "type": "object",
      "additionalProperties": false,
      "description": "Request form details supplied by the agent. There is no saved search: resubmit the requestFormID plus the full accumulated set of answers each time.",
      "properties": {
        "requestFormID": {
          "type": "string",
          "description": "The Request Form ID for this category, from search_home_service_pros."
        },
        "requestFormAnswers": {
          "type": "array",
          "description": "The full accumulated set of answers to request-form questions.",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "questionID": {
                "type": "string"
              },
              "answerIDs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "freeFormAnswer": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "dateAnswers": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                }
              }
            },
            "required": [
              "questionID"
            ]
          }
        }
      },
      "required": [
        "requestFormID"
      ]
    }
  },
  "required": [
    "zipCode",
    "categoryID",
    "requestForm"
  ]
}