# Change Enquiry State

Change the state of an enquiry in the sandbox environment, triggering its relevant event as well. You cannot go back to a previous state. If you specify QUOTED then it will trigger all eligible states before it, so in this example it would be SHORTLISTING and then finally QUOTED. Some states will be exceptions such as CLOSED which can happen in any of the previous states. This is not available in production.

Endpoint: POST /external-api/v1/sandbox/enquiries/{id}/change-state
Version: 1.0.1
Security: apiKey

## Path parameters:

  - `id` (string, required)
    Can be either the enquiries xeniaReference or externalId.
    Example: "R4E2F3A4"

## Request fields (application/json):

  - `closureReason` (string,null)
    The reason for the enquiry closure. This is not always available and may be null.
    Enum: "PRICE", "AVAILABILITY", "NO_CLIENT_RESPONSE", "STAY_CANCELLED_OR_POSTPONED", "BOOKED_ELSEWHERE_COMPETITOR", "BOOKED_ELSEWHERE_DIFFERENT_PRODUCT", "DUPLICATE", "NOT_AN_ENQUIRY", "STAY_DOES_NOT_MEET_SITU_CRITERIA", "OTHER"

  - `enquiryState` (string, required)
    The new state for the enquiry. You cannot go "back" with states, only progress them forward. This is not available in production.
    Enum: "SHORTLISTING", "QUOTED", "CLOSED"

## Response 404 fields (application/problem+json):

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.
    Example: "The request could not be understood due to malformed syntax."

  - `instance` (string)
    A URI reference or identifier that describes the specific occurrence of the problem.
    Example: "/api/v1/enquiries/abc"

  - `status` (integer, required)
    The HTTP status code.
    Example: 400

  - `title` (string, required)
    A short, human-readable summary of the problem type.
    Example: "Bad Request"

  - `type` (string, required)
    The error code as a machine-readable key.
    Enum: "RESOURCE_NOT_FOUND", "VALIDATION_ERROR", "RESOURCE_ALREADY_EXISTS", "DUPLICATE_CLIENT_REFERENCE", "GEOCODE_FAILURE", "MALFORMED_REQUEST", "INTERNAL_SERVER_ERROR", "MAX_RESOURCE_COUNT_REACHED", "SANDBOX_SPECIFIC_ACTION_ERROR"


## Response 204 fields

## Response 401 fields

## Response 403 fields