FIfindmydocument
Order Controller

Update order for admin

Changed on

Update order status and order date

patch/orders/{id}

Request

Path parameters

idnumber required

Request body

orderStatusIdnumber

Order status ID

orderDateTimestring

Order date time (ISO 8601 format)

address1string

Address line 1

flatUnitstring

Flat/Unit

municipalitystring

Municipality

registrystring

Registry

cruIdufirstring

CRU / IDUFIR (optional)

cadastralRefstring

Cadastral reference (Spain, optional)

propertyTypestring

Property type (Spain, required; defaults to "house"; stored lowercase trimmed)

ownerNamestring

Owner name (Spain, optional)

floorstring

Floor (Spain, optional)

doorstring

Door (Spain, optional)

requestReasonstring

Request reason (required for Spain orders)

identificationType'None' | 'NIE' | 'NIF'

Identification type

identificationNumberstring

Identification number (required when identification type is NIE or NIF)

nameAsPerIdentificationstring

Name as per identification (required when identification type is NIE or NIF)

citystring

City

suburbstring

Suburb

countystring

County

postCodestring

Post code (required for Spain orders)

countrystring

Country

statestring

State

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

updateItWithAllLinkedOrdersboolean

Update shipping address for all linked orders

hasSwimmingPoolboolean

Whether the 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

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

Order language

Example request

{
  "orderStatusId": 1,
  "orderDateTime": "2024-01-15T10:30:00.000Z",
  "address1": "123 Main Street",
  "flatUnit": "Flat 5B",
  "municipality": "Madrid",
  "registry": "Registro de la Propiedad",
  "cruIdufir": "1234567890",
  "cadastralRef": "1234567VK4700N0001AA",
  "propertyType": "house",
  "ownerName": "Juan García",
  "floor": "3",
  "door": "B",
  "requestReason": "Purchase due diligence",
  "identificationType": "None",
  "identificationNumber": "X1234567L",
  "nameAsPerIdentification": "John Doe",
  "city": "London",
  "suburb": "Ponsonby",
  "county": "Greater London",
  "postCode": "SW1A 1AA",
  "country": "United Kingdom",
  "state": "England",
  "shippingAddress1": "456 Delivery Street",
  "shippingAddress2": "Apartment 5B",
  "shippingCity": "Manchester",
  "shippingPostcode": "M1 1AA",
  "shippingCounty": "Greater Manchester",
  "shippingPhone": "+44 123 456 7890",
  "shippingFirstName": "John",
  "shippingLastName": "Doe",
  "applicantFirstName": "John",
  "applicantLastName": "Smith",
  "instrumentCopyNumber": "IC123456",
  "orderLng": "en"
}

Response

Order updated 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