Search
K
workspace v1

Update Party

This API allows the Law Firm to update existing borrower’s details within an existing workspace

patch
https://api.pexa.co.uk/partner/api/platformconnect/v1/workspaces/{workspace_id}/parties/{party_id}

Path Parameters

workspace_idstring(uuid)required

Workspace id

party_idstring(uuid)required

Headers

X-Request-Correlation-Idstring

The unique identifier for the request

Body

application/json

Update Party Request

Request to update party

typestringrequired

Allowed values: [INDIVIDUAL, ORGANISATION]

Match pattern:^(INDIVIDUAL|ORGANISATION)$

Example:INDIVIDUAL

nameChangeOnTitleboolean

Flag to indicate whether the user has consented for name change on title.

representationTypestring

Allowed values: [NO_REPRESENTATION, DUAL_REPRESENTATION, SEPARATE_REPRESENTATION]

Match pattern:^(NO_REPRESENTATION|DUAL_REPRESENTATION|SEPARATE_REPRESENTATION)$

Example:NO_REPRESENTATION

representationIdstring(uuid)
partyDetailsOne Of
Variant 1object
* Additional properties are NOT allowed.
Show Child Parameters
verificationOfIdentitystring

Allowed values: [LAW_FIRM_CERTIFIED, IDENTITY_EVIDENCE]

Match pattern:^(LAW_FIRM_CERTIFIED|IDENTITY_EVIDENCE)$

Example:LAW_FIRM_CERTIFIED

Response

application/json

OK

partyIdstring(uuid)read-only
rolestring

Allowed values: [BORROWER, OUTGOING_PROPRIETOR]

Match pattern:^(BORROWER|OUTGOING_PROPRIETOR)$

Example:BORROWER

proprietorMatchStatusarray[string]

Allowed values: [MATCH, NAME_MISMATCH, PENDING, PROPRIETOR_NAME_CHANGE_REQUIRED, TYPE_MISMATCH, REGISTRATION_NUMBER_MISMATCH, PARTY_NAME_UPDATED]

Match pattern:^(MATCH|NAME_MISMATCH|PENDING|PROPRIETOR_NAME_CHANGE_REQUIRED|TYPE_MISMATCH|REGISTRATION_NUMBER_MISMATCH|PARTY_NAME_UPDATED)$

Example:NAME_MISMATCH

typestringrequired

Allowed values: [INDIVIDUAL, ORGANISATION]

Match pattern:^(INDIVIDUAL|ORGANISATION)$

Example:INDIVIDUAL

partyDetailsOne Of
Variant 1object
Show Child Parameters
representationTypestring

Allowed values: [NO_REPRESENTATION, DUAL_REPRESENTATION, SEPARATE_REPRESENTATION]

Match pattern:^(NO_REPRESENTATION|DUAL_REPRESENTATION|SEPARATE_REPRESENTATION)$

Example:NO_REPRESENTATION

representationIdstring(uuid)
sourceProprietorIdstring(uuid)
verificationOfIdentitystring

Allowed values: [LAW_FIRM_CERTIFIED, IDENTITY_EVIDENCE]

Match pattern:^(LAW_FIRM_CERTIFIED|IDENTITY_EVIDENCE)$

Example:LAW_FIRM_CERTIFIED

patch/partner/api/platformconnect/v1/workspaces/{workspace_id}/parties/{party_id}

Body

{ "type": "INDIVIDUAL", "partyDetails": { "forenames": "James Thomas", "surname": "Smith" } }
 
application/json

CreateRemortgageWorkspaceRequest

object
referencestringrequired

>= 1 characters<= 25 characters

Example:109344235

propertyobjectrequired
Show Child Parameters
partiesOne Of
arrayrequired

minItems: 1 - Organisation borrower Party or 1 - Individual borrower Parties maxItems: 1 - Organisation borrower Party or 4 - Individual borrower Parties

Variant 1object
Show Child Parameters
participantsarray[object]required

>= 1 items<= 1 items

Show Child Parameters
Example

CreateRemortgageWorkspacePartyDto

object
rolestringrequired

Party Role:

  • BORROWER

Match pattern:^(BORROWER)$

Example

RemortgageIndividualDetails

object
rolestringrequired

Party Role:

  • BORROWER

Match pattern:^(BORROWER)$

typestringrequired

Party Type:

  • INDIVIDUAL

Match pattern:(INDIVIDUAL)

partyDetailsobjectrequired
Show Child Parameters
Example

RemortgageOrganisationDetails

object
rolestringrequired

Party Role:

  • BORROWER

Match pattern:^(BORROWER)$

typestringrequired

Party Type:

  • ORGANISATION

Match pattern:(ORGANISATION)

partyDetailsobjectrequired
Show Child Parameters
Example