FIfindmydocument
Order Controller

Create customer upSell order

Changed on

Allows customers to purchase recommended products. Fetches details from parent order. No authentication required.

post/orders/upsell

Request

Request body

parentOrderIdnumber required

Parent order ID to fetch customer and shipping details

productIdsnumber[] required

Array of product IDs to purchase as upsell

upSellSource'ORDER' | 'EMAIL' | 'ADMIN' | 'Document Link'

Source of the upsell order

orderLng'en' | 'fr' | 'de' | 'es'

Order language

suburbstring

Property suburb

shippingAddress1string

Shipping address line 1

shippingAddress2string

Shipping address line 2

shippingCitystring

Shipping city

shippingPostcodestring

Shipping postcode

shippingCountystring

Shipping county

shippingPhonestring

Shipping phone number

shippingFirstNamestring

Shipping first name

shippingLastNamestring

Shipping last name

hasSwimmingPoolboolean

Whether property has a swimming pool

applicantFirstNamestring

Applicant's first name for a LIM Report order

applicantLastNamestring

Applicant's last name for a LIM Report order

instrumentCopyNumberstring

Instrument copy number (optional)

productType'lim' | 'pf' | 'both'

Checkout UI the website rendered (lim, pf or both). Omit for the normal checkout flow.

Example request

{
  "parentOrderId": 123,
  "productIds": [
    2,
    3,
    5
  ],
  "upSellSource": "ORDER",
  "orderLng": "en",
  "suburb": "Ponsonby",
  "shippingAddress1": "221B Baker Street",
  "shippingAddress2": "Marylebone",
  "shippingCity": "London",
  "shippingPostcode": "NW1 6XE",
  "shippingCounty": "Greater London",
  "shippingPhone": "+441234567890",
  "shippingFirstName": "Sherlock",
  "shippingLastName": "Holmes",
  "hasSwimmingPool": true,
  "applicantFirstName": "John",
  "applicantLastName": "Smith",
  "instrumentCopyNumber": "123456789",
  "productType": "pf"
}

Response

UpSell order created successfully

orderIdnumber required

Order ID

customerEmailstring required

Customer email

emailValidboolean required

Email valid

emailValidationStatusstring

Email validation status (UNKNOWN, VALID, INVALID)

isNewCustomerboolean

True if customer was auto-created during this order

documentAccessLinkstring

Permanent document access link

Example response

{
  "orderId": 1,
  "customerEmail": "customer@example.com",
  "emailValid": true,
  "emailValidationStatus": "UNKNOWN",
  "isNewCustomer": true,
  "documentAccessLink": "https://api.example.com/orders/track/abc-123-xyz"
}

Changes