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

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

# RepresentationResponse

## 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:
    RepresentationResponse:
      type: object
      properties:
        representationId:
          type: string
          format: uuid
          description: Unique identifier for the representation
        partyId:
          type: string
          format: uuid
          description: The party identifier
        representedBy:
          type: string
          description: Type of representation
        subscriberId:
          type: string
          format: uuid
          description: PEXA subscriber ID (for PEXA subscriber representations)
        externalLawFirm:
          type: object
          required:
            - name
            - address
          properties:
            name:
              type: string
              minLength: 1
              maxLength: 160
              description: External law firm name
            address:
              type: object
              required:
                - postcode
              properties:
                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}))$
        referenceNumber:
          type: string
          description: Reference number (for external law firms)
        verificationOfIdentity:
          type: string
          pattern: ^(LAW_FIRM_CERTIFIED|IDENTITY_EVIDENCE)$
          example: LAW_FIRM_CERTIFIED
          description: |
            Allowed values: [`LAW_FIRM_CERTIFIED`, `IDENTITY_EVIDENCE`]
```