---
title: "UpdatePartyResponse"
url: "https://developer.pexa.co.uk/apis/workspace-v1-v1/versions/f42817f3-815f-4a74-8ba5-2f83efd8ab42/schemas/UpdatePartyResponse"
---

> Full API specification: https://developer.pexa.co.uk/apis/workspace-v1-v1/versions/f42817f3-815f-4a74-8ba5-2f83efd8ab42.md

# UpdatePartyResponse

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Workspace
  version: v1
servers:
  - url: https://api.pexa.co.uk
    description: API Gateway URL
components:
  schemas:
    UpdatePartyResponse:
      type: object
      required:
        - type
        - addresses
      properties:
        partyId:
          type: string
          format: uuid
          readOnly: true
        role:
          type: string
          pattern: ^(BORROWER|BUYER|SELLER|OUTGOING_PROPRIETOR|OUTGOING_LENDER)$
          example: BORROWER
          description: >
            Allowed values: [`BORROWER`, `BUYER`, `SELLER`,
            `OUTGOING_PROPRIETOR`, `OUTGOING_LENDER`]
        proprietorMatchStatus:
          type: array
          items:
            type: string
            pattern: ^(MATCH|NAME_MISMATCH|PENDING|PROPRIETOR_NAME_CHANGE_REQUIRED|TYPE_MISMATCH|REGISTRATION_NUMBER_MISMATCH|NOT_REQUIRED|PARTY_NAME_UPDATED)$
            example: NAME_MISMATCH
            description: >
              Allowed values: [`MATCH`, `NAME_MISMATCH`, `PENDING`,
              `PROPRIETOR_NAME_CHANGE_REQUIRED`, `TYPE_MISMATCH`,
              `REGISTRATION_NUMBER_MISMATCH`, `NOT_REQUIRED`,
              `PARTY_NAME_UPDATED`]
        type:
          type: string
          pattern: ^(INDIVIDUAL|ORGANISATION)$
          example: INDIVIDUAL
          description: |
            Allowed values: [`INDIVIDUAL`, `ORGANISATION`]
        partyDetails:
          oneOf:
            - type: object
              required:
                - forenames
                - surname
              properties:
                forenames:
                  maxLength: 90
                  minLength: 1
                  type: string
                  example: James Thomas
                  pattern: ^[A-Za-z][A-Za-z\- ']*$
                surname:
                  maxLength: 50
                  minLength: 1
                  type: string
                  example: Smith
                  pattern: ^[A-Za-z][A-Za-z\- ']*$
                email:
                  type: string
                  minLength: 1
                  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])+)\])
                  example: approver@lawfirm.com
            - type: object
              required:
                - organisationName
                - registrationNumber
                - organisationType
              properties:
                organisationName:
                  maxLength: 160
                  minLength: 1
                  type: string
                  example: My Organisation
                  pattern: ^[a-zA-ZÀ-ÖØ-öø-ſĀ-ıĴ-ľŁ-ŉŊ-ŏŐ-őŒ-žǼǺǾẀẂẄỲǽǻǿẁẃẅỳ\d&@£$€¥#‘’'(){}<>!«»“”"\[\]?*=%+\s.,:\/;\\-]+$
                registrationNumber:
                  type: string
                  minLength: 6
                  maxLength: 8
                  pattern: ^[A-Z0-9]+$
                  example: ABCD1234
                organisationType:
                  maxLength: 200
                  minLength: 1
                  type: string
                  pattern: ^(LIMITED_COMPANY)$
                  example: LIMITED_COMPANY
                  description: |
                    Organisation Type:
                     * `LIMITED_COMPANY`
                officers:
                  type: array
                  description: >
                    Organisation officers (e.g. directors/secretary) captured
                    for QES signing. Used to identify who should receive and
                    complete the signing invitation.
                  items:
                    type: object
                    required:
                      - forenames
                      - surname
                      - email
                      - role
                    properties:
                      forenames:
                        maxLength: 90
                        minLength: 1
                        type: string
                        example: James Thomas
                        pattern: ^[A-Za-z][A-Za-z\- ']*$
                      surname:
                        maxLength: 50
                        minLength: 1
                        type: string
                        example: Smith
                        pattern: ^[A-Za-z][A-Za-z\- ']*$
                      email:
                        type: string
                        minLength: 1
                        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])+)\])
                        example: approver@lawfirm.com
                      role:
                        type: string
                        pattern: ^(DIRECTOR|SECRETARY)$
                        example: DIRECTOR
                        description: |
                          Allowed values: [`DIRECTOR`, `SECRETARY`]
        representationType:
          type: string
          pattern: ^(NO_REPRESENTATION|DUAL_REPRESENTATION|SEPARATE_REPRESENTATION)$
          example: NO_REPRESENTATION
          description: >
            Allowed values: [`NO_REPRESENTATION`, `DUAL_REPRESENTATION`,
            `SEPARATE_REPRESENTATION`]
        representationId:
          type: string
          format: uuid
        representativeType:
          type: string
          pattern: ^(EXTERNAL_LAW_FIRM|PARTICIPANT)$
          example: EXTERNAL_LAW_FIRM
          description: |
            Allowed values: [`EXTERNAL_LAW_FIRM`, `PARTICIPANT`]
        sourceProprietorId:
          type: string
          format: uuid
        addresses:
          type: array
          items:
            type: object
            required:
              - type
              - details
            properties:
              type:
                type: string
                pattern: ^(REGISTERED_ADDRESS|CORRESPONDENCE_ADDRESS)$
                description: >
                  Address Type (Update Party API):
                   * `REGISTERED_ADDRESS` - to be used when party type is `ORGANISATION`
                   * `CORRESPONDENCE_ADDRESS` - to be used when party type is `INDIVIDUAL`
              details:
                required:
                  - postcode
                type: object
                properties:
                  addressId:
                    type: string
                    format: uuid
                    readOnly: true
                    example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  name:
                    maxLength: 50
                    minLength: 0
                    type: string
                    example: 1 The House
                  number:
                    maxLength: 4
                    minLength: 0
                    type: string
                    example: 123a
                  flat:
                    maxLength: 30
                    minLength: 0
                    type: string
                    example: Flat 32
                  street:
                    maxLength: 60
                    minLength: 0
                    type: string
                    example: Huddersfield
                  town:
                    maxLength: 30
                    minLength: 0
                    type: string
                    example: West Yorkshire
                  postcode:
                    maxLength: 8
                    minLength: 6
                    type: string
                    example: M16 0RA
                    pattern: ^(([Gg][Ii][Rr]
                      0[Aa]{2})|((([A-Za-z][0-9]{1,2})|(([A-Za-z][A-Ha-hJ-Yj-y][0-9]{1,2})|(([A-Za-z][0-9][A-Za-z])|([A-Za-z][A-Ha-hJ-Yj-y][0-9][A-Za-z]?))))\s[0-9][A-Za-z]{2}))$
        verificationOfIdentity:
          type: string
          pattern: ^(LAW_FIRM_CERTIFIED|IDENTITY_EVIDENCE)$
          example: LAW_FIRM_CERTIFIED
          description: |
            Allowed values: [`LAW_FIRM_CERTIFIED`, `IDENTITY_EVIDENCE`]
```
