Search
K
instruction v1

Cancel Instruction

This endpoint enables a lender to cancel an existing case instruction with either the panel management firm or the allocated law firm.

delete
https://api.pexa.co.uk/partner/api/platformconnect/v1/instructions/{instruction_id}

Path Parameters

instruction_idstringrequired

The unique identifier for the instruction to be cancelled

Headers

X-Request-Correlation-Idstring

The unique identifier for the request

Body

application/json
cancellationReasonstringrequired

Reason for cancelling the instruction.

Allowed values:
[OTHER]

Match pattern:^(OTHER)$

Example:OTHER

cancellationNotesForOtherstring

Mandatory when cancellationReason “OTHER” is provided

>= 1 characters<= 100 characters

Example:Incorrect details provided

Response

No Content

delete/partner/api/platformconnect/v1/instructions/{instruction_id}

Body

{ "cancellationReason": "OTHER", "cancellationNotesForOther": "Incorrect details provided" }
 

CreateInstructionRequest

object
routingConfigobjectrequired

Information used to determine where to route the instruction

Show Child Parameters
instructionsDetailsobjectrequired
Show Child Parameters
Example

RoutingConfig

object

Information used to determine where to route the instruction

assignedPanelManagerstring

The assigned panel manager Allowed Values: [ SMOOVE]

Match pattern:^(SMOOVE)$

assignedPanelLawFirmstring

Panel reference held by the Panel Manager for the law firm

<= 50 characters

assignedLawFirmstring

The actual law firm name Allowed Values: [ OPTIMA ]

Match pattern:^(OPTIMA)$

pexaEligibleboolean

Indicates if the funds should be settled by PEXA

Example

InstructionsDetails

object
referencestringrequired

The lender held reference for the mortgage application

>= 1 characters<= 40 characters

loanAmountnumber(double)

The amount of the loan

>= 1

transactionTypestringrequired

Allowed values: [ PURCHASE, REMORTGAGE ]

Match pattern:^(PURCHASE|REMORTGAGE)$

serviceLevelstring

Level of service required for this instruction Allowed values: [ STANDARD, PREMIER ]

Match pattern:^(STANDARD|PREMIER)$

lenderobject
Show Child Parameters
propertyobjectrequired
Show Child Parameters
partiesOne Of
arrayrequired

Information about the applicants, introducer, and outgoing lender (up to 4 applicants plus introducer and outgoing lender as needed)

Variant 1object
Show Child Parameters
mortgagePrisonerboolean

Indicates if this is a mortgage prisoner

Example

Lender

object
accountNumberstring

The lender account number

sortCodestring

The lender sort code

Example