# Unsolicited Cease

Endpoint: POST /unsolicitedCeaseRequest
Version: 2.31

## Request fields (application/xml):

  - `message` (object, required)
    The meta-data of the request. It includes information regarding the message UUID, transaction ID and the sent timestamp

  - `message.messageId` (string, required)
    A unique ID to identify the message
    Example: b68b2cf4-475e-11e1-a92e-fb2ff6467c99

  - `message.correlationId` (string, required)
    A Correlation ID, also known as a Transit ID, is a unique identifier value that is attached to requests and messages that allow reference to a particular transaction or event chain
    Example: bac72cfa-475e-11e1-a92e-fb2ff6467c99

  - `message.sentAt` (string, required)
    The timestamp when the message has been sent
    Example: 2012-01-20T18:30:43Z

  - `buyer` (object, required)
    The Service Provider who consumes the service is the buyer

  - `buyer.buyerIdentifier` (string, required)
    Unique identifier of the buyer
    Example: SPDEV1

  - `buyer.cfh:resellerId` (string)
    Unique identifier of the reseller. Sourced from the Ofcom Reseller Identification List
    Example: BAQ

  - `seller` (object, required)
    the Active Network Operator who provides the service is the seller

  - `seller.sellerIdentifier` (string, required)
    Unique identifier of the seller
    Example: CITYFIBRE

  - `orderReferences` (object, required)
    Reference for the order for this buyer

  - `orderReferences.buyerOrderReference` (string, required)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `serviceIdentifier` (string, required)
    Unique Identifier for the service
    Example: S12345

  - `requestedDate` (string, required)
    Point at which the change should be applied
    Example: 2022-01-20T18:30:43Z

  - `cfh:newOrderType` (string)
    Order type options:
* `Regrade` - where the end customer is changing to a new product
* `Switch` - where the end customer is changing to a new internet provider (Buyer)
* `WLTO` - where the end customer is moving to a new location
    Enum: "Regrade", "Switch", "WLTO"

  - `notes` (string)
    Example: No Toby to property

## Response 200 fields (application/xml):

  - `unsolicitedCeaseResponse` (null)