Search
K
lodgement v1

Update Lodgement Application Attribute

This API is used to update the attribute values for a given lodgement application id

patch
https://api.pexa.co.uk/partner/api/platformconnect/v1/lodgement-cases/{lodgement_case_id}/applications/{application_id}

Path Parameters

lodgement_case_idstring(uuid)required

Lodgement case id

application_idstring(uuid)required

Application id

Headers

X-Request-Correlation-Idstring

The unique identifier for the request

Body

application/json
transactionValuenumber

Example:100

mortgageDeedReferencestring

Example:DN100

mortgageDeedReferenceTypestring

Allowed values:
[PAPER, DIGITAL]

Match pattern:^(PAPER|DIGITAL)$

Example:PAPER

isEffectiveboolean

Example:true

Response

application/json

OK

applicationIdstring(uuid)read-only
applicationTypestring

Example:MORTGAGE_DEED

statusstringread-only
submittedAtstring(date-time)
submittedBystring
auditAttributesobject
Show Child Parameters
fileobject
Show Child Parameters
attributesobject
Show Child Parameters
patch/partner/api/platformconnect/v1/lodgement-cases/{lodgement_case_id}/applications/{application_id}

Body

{}
{}
  
curl --request PATCH \
  --url https://api.pexa.co.uk/partner/api/platformconnect/v1/lodgement-cases//applications/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer' \
  --header 'Content-Type: application/json' \
  --data '{}'
application/json
{
  "applicationId": "applicationId",
  "applicationType": "MORTGAGE_DEED",
  "status": "status",
  "submittedAt": "submittedAt",
  "submittedBy": "submittedBy",
  "auditAttributes": {
    "createdAt": "createdAt",
    "createdBy": "createdBy",
    "lastModifiedAt": "lastModifiedAt",
    "lastModifiedBy": "lastModifiedBy"
  },
  "file": {
    "fileId": "fileId",
    "fileName": "sample_document.pdf",
    "fileUploadStatus": "SUCCESS",
    "auditAttributes": {
      "createdAt": "createdAt",
      "createdBy": "createdBy",
      "lastModifiedAt": "lastModifiedAt",
      "lastModifiedBy": "lastModifiedBy"
    }
  },
  "attributes": {
    "applicationType": "applicationType",
    "transactionValue": 100,
    "landRegistryFee": 100,
    "certificationType": "CERTIFIED",
    "mortgageDeedReference": "DN100",
    "mortgageDeedReferenceType": "PAPER",
    "isEffective": true
  }
}

Upload and Attach Document

This API is used to upload & attach a document to the lodgement application associated to the workspace, such as a mortgage deed

Note: In the event of eDeed please update mortgageDeedReference and mortgageDeedReferenceType using Update Lodgement Application Attribute before uploading

post
https://api.pexa.co.uk/partner/api/platformconnect/v1/lodgement-cases/{lodgement_case_id}/applications/{application_id}/attachments

Path Parameters

lodgement_case_idstring(uuid)required

Lodgement case id

application_idstring(uuid)required

Application id

Headers

X-Request-Correlation-Idstring

The unique identifier for the request

Body

multipart/form-data
filestringrequired

Allowed format: [PDF]

Example:sample_document.pdf

documentTypestringrequired

Allowed values: [MORTGAGE_DEED,
EVIDENCE,
CORRESPONDENCE,
IDENTITY_EVIDENCE,
IDENTITY_FORM,
BIRTH_CERTIFICATE,
MARRIAGE_CERTIFICATE,
STATEMENT_OF_TRUTH,
STATUTORY_DECLARATION,
PG82_CERTIFICATE,
COMPANIES_HOUSE_CERTIFICATE,
COMPANIES_HOUSE_EVIDENCE]

Example:MORTGAGE_DEED

documentCategorystringrequired

Allowed values: [APPLICATION_DOCUMENT, SUPPORTING_DOCUMENT]

Example:APPLICATION_DOCUMENT

certificationTypestringrequired

Allowed values: [CERTIFIED, ORIGINAL, SCANNED]

Match pattern:(CERTIFIED|ORIGINAL|SCANNED)

Example:CERTIFIED

Response

application/json

ACCEPTED

fileIdstring(uuid)required
post/partner/api/platformconnect/v1/lodgement-cases/{lodgement_case_id}/applications/{application_id}/attachments

Body

{
  "file": "sample_document.pdf",
  "documentType": "MORTGAGE_DEED",
  "documentCategory": "APPLICATION_DOCUMENT",
  "certificationType": "CERTIFIED"
}
{ "file": "sample_document.pdf", "documentType": "MORTGAGE_DEED", "documentCategory": "APPLICATION_DOCUMENT", "certificationType": "CERTIFIED" }
  
curl --request POST \
  --url https://api.pexa.co.uk/partner/api/platformconnect/v1/lodgement-cases//applications//attachments \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer' \
  --header 'Content-Type: multipart/form-data' \
  --data '{
  "file": "sample_document.pdf",
  "documentType": "MORTGAGE_DEED",
  "documentCategory": "APPLICATION_DOCUMENT",
  "certificationType": "CERTIFIED"
}'
application/json
{
  "fileId": "fileId"
}

Upload Document

This API is used to upload documents to workspace such as offer document as well as upload & attach a document to the lodgement application associated to the workspace, such as a mortgage deed.

Note: In the event of eDeed please update mortgageDeedReference and mortgageDeedReferenceType using Update Lodgement Application Attribute before uploading

post
https://api.pexa.co.uk/partner/api/platformconnect/v1/workspaces/{workspace_id}/files

Path Parameters

workspace_idstring(uuid)required

Workspace id

Headers

X-Request-Correlation-Idstring

The unique identifier for the request

Body

multipart/form-data
filestringrequired

Allowed format: [PDF]

Example:sample_document.pdf

documentTypestringrequired

Allowed values: [MORTGAGE_DEED,
BIRTH_CERTIFICATE,
CORRESPONDENCE,
EVIDENCE,
IDENTITY_EVIDENCE,
IDENTITY_FORM,
MARRIAGE_CERTIFICATE,
STATEMENT_OF_TRUTH,
STATUTORY_DECLARATION,
MORTGAGE_OFFER,
REDEMPTION_STATEMENT,
PG82_CERTIFICATE,
COMPANIES_HOUSE_CERTIFICATE,
COMPANIES_HOUSE_EVIDENCE]

Example:MORTGAGE_DEED

applicationIdstring(uuid)

To attach the uploaded document to a specific application, the corresponding Application ID must be provided. This value is not required when uploading a document to Workspace without having to attach to an application.

Example:123e4567-e89b-12d3-a456-426614174000

documentCategorystringrequired

Allowed values: [APPLICATION_DOCUMENT,
SUPPORTING_DOCUMENT,
WORKSPACE_SUPPORTING_DOCUMENT]

Example:APPLICATION_DOCUMENT

certificationTypestring

Allowed values: [CERTIFIED, ORIGINAL, SCANNED]

Match pattern:(CERTIFIED|ORIGINAL|SCANNED)

Example:CERTIFIED

Response

application/json

ACCEPTED

fileIdstring(uuid)required
post/partner/api/platformconnect/v1/workspaces/{workspace_id}/files

Body

{
  "file": "sample_document.pdf",
  "documentType": "MORTGAGE_DEED",
  "documentCategory": "APPLICATION_DOCUMENT"
}
{ "file": "sample_document.pdf", "documentType": "MORTGAGE_DEED", "documentCategory": "APPLICATION_DOCUMENT" }
  
curl --request POST \
  --url https://api.pexa.co.uk/partner/api/platformconnect/v1/workspaces//files \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer' \
  --header 'Content-Type: multipart/form-data' \
  --data '{
  "file": "sample_document.pdf",
  "documentType": "MORTGAGE_DEED",
  "documentCategory": "APPLICATION_DOCUMENT"
}'
application/json
{
  "fileId": "fileId"
}

Download Title Document - JSON

This API is used to download document content in JSON format from an existing workspace

get
https://api.pexa.co.uk/partner/api/platformconnect/v1/lodgement-cases/{lodgement_case_id}/titles/{title_id}/title-documents

Query Parameters

document_typestring

Supported document types in title

Allowed values:TITLE_REGISTERTITLE_INFORMATION_DOCUMENTEARLY_COMPLETION_TITLE_INFORMATION_DOCUMENT

Path Parameters

lodgement_case_idstring(uuid)required

Lodgement case id

title_idstring(uuid)required

Title id

Headers

X-Request-Correlation-Idstring

The unique identifier for the request

Response

application/json

OK

recordsarray[object]
Show Child Parameters
get/partner/api/platformconnect/v1/lodgement-cases/{lodgement_case_id}/titles/{title_id}/title-documents
  
curl --request GET \
  --url https://api.pexa.co.uk/partner/api/platformconnect/v1/lodgement-cases//titles//title-documents \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer' \
  --header 'Content-Type: application/json'
application/json
{
  "records": [
    {
      "titleDocumentId": "64c95d57-b54d-460f-9a85-ef3612f35a03",
      "documentType": "TITLE_INFORMATION_DOCUMENT",
      "fileId": "e24c1119-4f17-4f20-90f9-bcbfa4fdfa03",
      "documentAttributes": {
        "propertyAddress": {
          "lineOne": "36 Lets B Avenue",
          "lineTwo": "Bodmin"
        },
        "title": {
          "titleNumber": "WK500270"
        },
        "proprietorship": {
          "registeredProprietors": [
            {
              "individual": {
                "forenames": "Sidney",
                "surname": "Youngblood"
              },
              "addresses": [
                {
                  "lineOne": "5 Cromwell Street",
                  "lineTwo": "Gloucester",
                  "lineThree": "Gloucestershire",
                  "postcode": "GL1 1RE"
                }
              ]
            }
          ]
        },
        "charges": [
          {
            "chargeDate": "2012-05-21",
            "registrationDate": "2012-05-22",
            "chargeeParties": [
              {
                "organizationName": "Abbey National PLC",
                "address": {
                  "lineOne": "Deeds Services",
                  "lineTwo": "101 Midsummer Boulevard",
                  "lineThree": "Milton Keynes",
                  "postcode": "MK9 1AA"
                }
              }
            ],
            "additionalDetails": {
              "restrictionDetails": [
                {
                  "chargeRestriction": {
                    "reason": "RESTRICTION: No disposition",
                    "chargeParty": "Abbey National PLC",
                    "chargeDate": "2012-05-21"
                  }
                }
              ]
            }
          }
        ]
      }
    }
  ]
}

Approve or Unapprove Lodgement Applications

This endpoint is used by conveyancing law firms to approve a lodgement case so the workspace can be prepared.

post
https://api.pexa.co.uk/partner/api/platformconnect/v1/workspaces/{workspace_id}/lodgement-approvals

Path Parameters

workspace_idstring(uuid)required

Workspace id

Headers

X-Request-Correlation-Idstring

The unique identifier for the request

Body

application/json
actionstringrequired

Action to perform on lodgement applications
Allowed values: [APPROVE, UNAPPROVE]

Match pattern:^(APPROVE|UNAPPROVE)$

Example:APPROVE

approvedBystringrequired

Email address of the user who performed the approval action

Match pattern:^$|(?:[A-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[A-z0-9](?:[A-z0-9-]*[A-z0-9])?\.)+[A-z0-9](?:[A-z0-9-]*[A-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[A-z0-9-]*[A-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5A\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])

>= 1 characters

Example:approver@lawfirm.com

Response

application/json

ACCEPTED

lodgementCaseIdstring(uuid)required

Lodgement case id for which the applications will be approved or unapproved

post/partner/api/platformconnect/v1/workspaces/{workspace_id}/lodgement-approvals

Body

{
  "action": "APPROVE",
  "approvedBy": "approver@lawfirm.com"
}
{ "action": "APPROVE", "approvedBy": "approver@lawfirm.com" }
  
curl --request POST \
  --url https://api.pexa.co.uk/partner/api/platformconnect/v1/workspaces//lodgement-approvals \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "APPROVE",
  "approvedBy": "approver@lawfirm.com"
}'
application/json
{
  "lodgementCaseId": "lodgementCaseId"
}