@planning-inspectorate/data-model 1.20.0 → 1.21.0

package/docs/README.md

@@ -34,7 +34,7 @@
 
 * [NSIP Project Update](./nsip-project-update.md "NSIP Project Update (formerly known as Banners)") – `nsip-project-update.schema.json`
 
-* [PINS Inspector](./pins-inspector.md "Inspector attributes as per Horizon") – `pins-inspector.schema.json`
+* [PINS Inspector](./pins-inspector.md "Inspector Details originating from Horizon, SAP HR and Entra") – `pins-inspector.schema.json`
 
 * [PINS LPA](./pins-lpa.md "Local Planning Authority (LPA) attributes as per Horizon") – `pins-lpa.schema.json`
 
@@ -64,6 +64,10 @@
 
 * [Untitled object in NSIP Project](./nsip-project-defs-invoice.md "An invoice related to the project") – `nsip-project.schema.json#/$defs/invoice`
 
+* [Untitled object in PINS Inspector](./pins-inspector-properties-address.md) – `pins-inspector.schema.json#/properties/address`
+
+* [Untitled object in PINS Inspector](./pins-inspector-defs-specialism.md) – `pins-inspector.schema.json#/$defs/specialism`
+
 ### Arrays
 
 * [Untitled array in Appeal Representation](./appeal-representation-properties-documentids.md "An array of documentIds") – `appeal-representation.schema.json#/properties/documentIds`
@@ -96,6 +100,8 @@
 
 * [Untitled array in NSIP Project](./nsip-project-properties-invoices.md "Collection of invoices associated with this project") – `nsip-project.schema.json#/properties/invoices`
 
+* [Untitled array in PINS Inspector](./pins-inspector-properties-specialisms.md) – `pins-inspector.schema.json#/properties/specialisms`
+
 * [Untitled array in Representation](./nsip-representation-properties-attachmentids.md) – `nsip-representation.schema.json#/properties/attachmentIds`
 
 * [Untitled array in S51 Advice](./s51-advice-properties-attachmentids.md) – `s51-advice.schema.json#/properties/attachmentIds`

package/docs/pins-inspector-defs-specialism.md

@@ -0,0 +1,80 @@
+## specialism Type
+
+`object` ([Details](pins-inspector-defs-specialism.md))
+
+# specialism Properties
+
+| Property                    | Type     | Required | Nullable       | Defined by                                                                                                                                       |
+| :-------------------------- | :------- | :------- | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |
+| [name](#name)               | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-defs-specialism-properties-name.md "pins-inspector.schema.json#/$defs/specialism/properties/name")               |
+| [proficiency](#proficiency) | `string` | Required | can be null    | [PINS Inspector](pins-inspector-defs-specialism-properties-proficiency.md "pins-inspector.schema.json#/$defs/specialism/properties/proficiency") |
+| [validFrom](#validfrom)     | `string` | Required | can be null    | [PINS Inspector](pins-inspector-defs-specialism-properties-validfrom.md "pins-inspector.schema.json#/$defs/specialism/properties/validFrom")     |
+| Additional Properties       | Any      | Optional | can be null    |                                                                                                                                                  |
+
+## name
+
+Working above band is stored as a specialism
+
+`name`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-defs-specialism-properties-name.md "pins-inspector.schema.json#/$defs/specialism/properties/name")
+
+### name Type
+
+`string`
+
+## proficiency
+
+trained or in-training
+
+`proficiency`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [PINS Inspector](pins-inspector-defs-specialism-properties-proficiency.md "pins-inspector.schema.json#/$defs/specialism/properties/proficiency")
+
+### proficiency Type
+
+`string`
+
+## validFrom
+
+Date training started or date training was completed.
+
+`validFrom`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [PINS Inspector](pins-inspector-defs-specialism-properties-validfrom.md "pins-inspector.schema.json#/$defs/specialism/properties/validFrom")
+
+### validFrom Type
+
+`string`
+
+### validFrom Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+### validFrom Examples
+
+```json
+"2023-07-27T20:30:00.000Z"
+```
+
+## Additional Properties
+
+Additional properties are allowed and do not have to follow a specific schema

package/docs/pins-inspector-defs.md

@@ -0,0 +1,3 @@
+## $defs Type
+
+unknown

package/docs/pins-inspector.md

@@ -6,7 +6,9 @@
 
 | Property                              | Type     | Required | Nullable       | Defined by                                                                                                                |
 | :------------------------------------ | :------- | :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------ |
-| [horizonId](#horizonid)               | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-horizonid.md "pins-inspector.schema.json#/properties/horizonId")               |
+| [entraId](#entraid)                   | `string` | Required | can be null    | [PINS Inspector](pins-inspector-properties-entraid.md "pins-inspector.schema.json#/properties/entraId")                   |
+| [sapId](#sapid)                       | `string` | Required | can be null    | [PINS Inspector](pins-inspector-properties-sapid.md "pins-inspector.schema.json#/properties/sapId")                       |
+| [horizonId](#horizonid)               | `string` | Optional | cannot be null | [PINS Inspector](pins-inspector-properties-horizonid.md "pins-inspector.schema.json#/properties/horizonId")               |
 | [firstName](#firstname)               | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-firstname.md "pins-inspector.schema.json#/properties/firstName")               |
 | [lastName](#lastname)                 | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-lastname.md "pins-inspector.schema.json#/properties/lastName")                 |
 | [postName](#postname)                 | `string` | Optional | can be null    | [PINS Inspector](pins-inspector-properties-postname.md "pins-inspector.schema.json#/properties/postName")                 |
@@ -15,15 +17,60 @@
 | [salutation](#salutation)             | `string` | Optional | can be null    | [PINS Inspector](pins-inspector-properties-salutation.md "pins-inspector.schema.json#/properties/salutation")             |
 | [qualifications](#qualifications)     | `string` | Optional | can be null    | [PINS Inspector](pins-inspector-properties-qualifications.md "pins-inspector.schema.json#/properties/qualifications")     |
 | [email](#email)                       | `string` | Required | can be null    | [PINS Inspector](pins-inspector-properties-email.md "pins-inspector.schema.json#/properties/email")                       |
+| [grade](#grade)                       | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-grade.md "pins-inspector.schema.json#/properties/grade")                       |
+| [fte](#fte)                           | `number` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-fte.md "pins-inspector.schema.json#/properties/fte")                           |
+| [unit](#unit)                         | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-unit.md "pins-inspector.schema.json#/properties/unit")                         |
+| [service](#service)                   | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-service.md "pins-inspector.schema.json#/properties/service")                   |
+| [group](#group)                       | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-group.md "pins-inspector.schema.json#/properties/group")                       |
+| [inspectorManager](#inspectormanager) | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-inspectormanager.md "pins-inspector.schema.json#/properties/inspectorManager") |
+| [validFrom](#validfrom)               | `string` | Optional | can be null    | [PINS Inspector](pins-inspector-properties-validfrom.md "pins-inspector.schema.json#/properties/validFrom")               |
+| [address](#address)                   | `object` | Required | cannot be null | [PINS Inspector](pins-inspector-properties-address.md "pins-inspector.schema.json#/properties/address")                   |
+| [specialisms](#specialisms)           | `array`  | Required | cannot be null | [PINS Inspector](pins-inspector-properties-specialisms.md "pins-inspector.schema.json#/properties/specialisms")           |
 | Additional Properties                 | Any      | Optional | can be null    |                                                                                                                           |
 
+## entraId
+
+EntraID of the Inspector if available in ODW.
+
+`entraId`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-entraid.md "pins-inspector.schema.json#/properties/entraId")
+
+### entraId Type
+
+`string`
+
+## sapId
+
+SAPID of the Inspector if available in ODW.
+
+`sapId`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-sapid.md "pins-inspector.schema.json#/properties/sapId")
+
+### sapId Type
+
+`string`
+
 ## horizonId
 
 The PINS-generated unique horizon ID
 
 `horizonId`
 
-* is required
+* is optional
 
 * Type: `string`
 
@@ -163,7 +210,7 @@ The qualifications of the inspector
 
 ## email
 
-The email address of the inspector
+PINS Email address for the Inspector
 
 `email`
 
@@ -179,6 +226,267 @@ The email address of the inspector
 
 `string`
 
+### email Constraints
+
+**email**: the string must be an email address, according to [RFC 5322, section 3.4.1](https://tools.ietf.org/html/rfc5322 "check the specification")
+
+## grade
+
+Grades as a coded value e.g. B1, B2, B3, FTC-B1, FTC-B2, FTC-B3, PL
+
+`grade`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-grade.md "pins-inspector.schema.json#/properties/grade")
+
+### grade Type
+
+`string`
+
+## fte
+
+FTE Decimal value e.g. 1, 0.5 etc
+
+`fte`
+
+* is required
+
+* Type: `number`
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-fte.md "pins-inspector.schema.json#/properties/fte")
+
+### fte Type
+
+`number`
+
+## unit
+
+The personnel area of the Inspector
+
+`unit`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-unit.md "pins-inspector.schema.json#/properties/unit")
+
+### unit Type
+
+`string`
+
+## service
+
+The personnel sub area of the Inspector
+
+`service`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-service.md "pins-inspector.schema.json#/properties/service")
+
+### service Type
+
+`string`
+
+## group
+
+Group of the Inspector
+
+`group`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-group.md "pins-inspector.schema.json#/properties/group")
+
+### group Type
+
+`string`
+
+## inspectorManager
+
+Name of the Inspector's manager.
+
+`inspectorManager`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-inspectormanager.md "pins-inspector.schema.json#/properties/inspectorManager")
+
+### inspectorManager Type
+
+`string`
+
+## validFrom
+
+Date the Inspector record was first recorded.
+
+`validFrom`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-validfrom.md "pins-inspector.schema.json#/properties/validFrom")
+
+### validFrom Type
+
+`string`
+
+### validFrom Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+### validFrom Examples
+
+```json
+"2023-07-27T20:30:00.000Z"
+```
+
+## address
+
+
+
+`address`
+
+* is required
+
+* Type: `object` ([Details](pins-inspector-properties-address.md))
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-address.md "pins-inspector.schema.json#/properties/address")
+
+### address Type
+
+`object` ([Details](pins-inspector-properties-address.md))
+
+## specialisms
+
+
+
+`specialisms`
+
+* is required
+
+* Type: `object[]` ([Details](pins-inspector-defs-specialism.md))
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-properties-specialisms.md "pins-inspector.schema.json#/properties/specialisms")
+
+### specialisms Type
+
+`object[]` ([Details](pins-inspector-defs-specialism.md))
+
 ## Additional Properties
 
 Additional properties are allowed and do not have to follow a specific schema
+
+# PINS Inspector Definitions
+
+## Definitions group specialism
+
+Reference this group by using
+
+```json
+{"$ref":"pins-inspector.schema.json#/$defs/specialism"}
+```
+
+| Property                    | Type     | Required | Nullable       | Defined by                                                                                                                                       |
+| :-------------------------- | :------- | :------- | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |
+| [name](#name)               | `string` | Required | cannot be null | [PINS Inspector](pins-inspector-defs-specialism-properties-name.md "pins-inspector.schema.json#/$defs/specialism/properties/name")               |
+| [proficiency](#proficiency) | `string` | Required | can be null    | [PINS Inspector](pins-inspector-defs-specialism-properties-proficiency.md "pins-inspector.schema.json#/$defs/specialism/properties/proficiency") |
+| [validFrom](#validfrom-1)   | `string` | Required | can be null    | [PINS Inspector](pins-inspector-defs-specialism-properties-validfrom.md "pins-inspector.schema.json#/$defs/specialism/properties/validFrom")     |
+| Additional Properties       | Any      | Optional | can be null    |                                                                                                                                                  |
+
+### name
+
+Working above band is stored as a specialism
+
+`name`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [PINS Inspector](pins-inspector-defs-specialism-properties-name.md "pins-inspector.schema.json#/$defs/specialism/properties/name")
+
+#### name Type
+
+`string`
+
+### proficiency
+
+trained or in-training
+
+`proficiency`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [PINS Inspector](pins-inspector-defs-specialism-properties-proficiency.md "pins-inspector.schema.json#/$defs/specialism/properties/proficiency")
+
+#### proficiency Type
+
+`string`
+
+### validFrom
+
+Date training started or date training was completed.
+
+`validFrom`
+
+* is required
+
+* Type: `string`
+
+* can be null
+
+* defined in: [PINS Inspector](pins-inspector-defs-specialism-properties-validfrom.md "pins-inspector.schema.json#/$defs/specialism/properties/validFrom")
+
+#### validFrom Type
+
+`string`
+
+#### validFrom Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+#### validFrom Examples
+
+```json
+"2023-07-27T20:30:00.000Z"
+```
+
+### Additional Properties
+
+Additional properties are allowed and do not have to follow a specific schema

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planning-inspectorate/data-model",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "JSON Schemas for the Planning Inspectorate's Data Model",
   "main": "src/index.js",
   "type": "module",

package/pins_data_model/models/model_appeal_document.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-document.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:33:59+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_event.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:33:59+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_event_estimate.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event-estimate.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:33:59+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_has.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-has.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:33:59+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_representation.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-representation.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:33:59+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_s78.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-s78.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_dart_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  dart-response.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_entraid.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  entraid.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_folder.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  folder.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_gettimesheets_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  gettimesheets-response.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_listed_building.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  listed-building.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_listed_buildings.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  listed-buildings.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_document.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-document.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_exam_timetable.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-exam-timetable.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_project.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-project.schema.json
-#   timestamp: 2025-10-30T20:02:32+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_project_update.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-project-update.schema.json
-#   timestamp: 2025-10-30T20:02:31+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_representation.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-representation.schema.json
-#   timestamp: 2025-10-30T20:02:32+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_subscription.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-subscription.schema.json
-#   timestamp: 2025-10-30T20:02:32+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_pins_inspector.py

@@ -1,21 +1,58 @@
 # generated by datamodel-codegen:
 #   filename:  pins-inspector.schema.json
-#   timestamp: 2025-10-30T20:02:32+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 
-from pydantic import BaseModel, ConfigDict
+from pydantic import AwareDatetime, BaseModel, ConfigDict, EmailStr, Field
+
+
+class Address(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    addressLine1: str | None = None
+    addressLine2: str | None = None
+    townCity: str | None = None
+    county: str | None = None
+    postcode: str | None = None
+
+
+class Specialism(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    name: str = Field(..., examples=["S62A Casework Major"])
+    """
+    Working above band is stored as a specialism
+    """
+    proficiency: str | None = Field(..., examples=["trained"])
+    """
+    trained or in-training
+    """
+    validFrom: AwareDatetime | None = Field(..., examples=["2023-07-27T20:30:00.000Z"])
+    """
+    Date training started or date training was completed.
+    """
 
 
 class PinsInspector(BaseModel):
     """
-    Inspector attributes as per Horizon. This will be extended with SAP/Entra data
+    Inspector Details originating from Horizon, SAP HR and Entra.
     """
 
     model_config = ConfigDict(
         extra="allow",
     )
-    horizonId: str
+    entraId: str | None = Field(..., examples=["00000000-0000-0000-0000-000000000000"])
+    """
+    EntraID of the Inspector if available in ODW.
+    """
+    sapId: str | None = Field(..., examples=["12345678"])
+    """
+    SAPID of the Inspector if available in ODW.
+    """
+    horizonId: str | None = None
     """
     The PINS-generated unique horizon ID
     """
@@ -47,7 +84,39 @@ class PinsInspector(BaseModel):
     """
     The qualifications of the inspector
     """
-    email: str | None = None
+    email: EmailStr | None = Field(
+        ..., examples=["example@planninginspectorate.gov.uk"]
+    )
+    """
+    PINS Email address for the Inspector
+    """
+    grade: str = Field(..., examples=["B1"])
+    """
+    Grades as a coded value e.g. B1, B2, B3, FTC-B1, FTC-B2, FTC-B3, PL
+    """
+    fte: float = Field(..., examples=[0.75])
+    """
+    FTE Decimal value e.g. 1, 0.5 etc
+    """
+    unit: str = Field(..., examples=["Operations"])
+    """
+    The personnel area of the Inspector
+    """
+    service: str = Field(..., examples=["Planning and Environmental Appeals Service"])
+    """
+    The personnel sub area of the Inspector
+    """
+    group: str = Field(..., examples=["Enforcement Groups"])
+    """
+    Group of the Inspector
+    """
+    inspectorManager: str = Field(..., examples=["Dan Brown"])
+    """
+    Name of the Inspector's manager.
+    """
+    validFrom: AwareDatetime | None = Field(None, examples=["2023-07-27T20:30:00.000Z"])
     """
-    The email address of the inspector
+    Date the Inspector record was first recorded.
     """
+    address: Address
+    specialisms: list[Specialism]

package/pins_data_model/models/model_pins_lpa.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pins-lpa.schema.json
-#   timestamp: 2025-10-30T20:02:32+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_s51_advice.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  s51-advice.schema.json
-#   timestamp: 2025-10-30T20:02:32+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_service_user.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  service-user.schema.json
-#   timestamp: 2025-10-30T20:02:32+00:00
+#   timestamp: 2025-11-04T12:34:00+00:00
 
 from __future__ import annotations
 

package/schemas/pins-inspector.schema.json

@@ -2,11 +2,35 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "pins-inspector.schema.json",
   "title": "PINS Inspector",
-  "description": "Inspector attributes as per Horizon. This will be extended with SAP/Entra data",
+  "description": "Inspector Details originating from Horizon, SAP HR and Entra.",
   "type": "object",
   "additionalProperties": true,
-  "required": ["firstName", "lastName", "horizonId", "email"],
+  "required": [
+    "entraId",
+    "sapId",
+    "firstName",
+    "lastName",
+    "email",
+    "grade",
+    "fte",
+    "unit",
+    "service",
+    "group",
+    "inspectorManager",
+    "address",
+    "specialisms"
+  ],
   "properties": {
+    "entraId": {
+      "type": ["string", "null"],
+      "description": "EntraID of the Inspector if available in ODW.",
+      "example": "00000000-0000-0000-0000-000000000000"
+    },
+    "sapId": {
+      "type": ["string", "null"],
+      "description": "SAPID of the Inspector if available in ODW.",
+      "example": "12345678"
+    },
     "horizonId": {
       "type": "string",
       "description": "The PINS-generated unique horizon ID"
@@ -41,7 +65,88 @@
     },
     "email": {
       "type": ["string", "null"],
-      "description": "The email address of the inspector"
+      "format": "email",
+      "description": "PINS Email address for the Inspector",
+      "example": "example@planninginspectorate.gov.uk"
+    },
+    "grade": {
+      "type": "string",
+      "description": "Grades as a coded value e.g. B1, B2, B3, FTC-B1, FTC-B2, FTC-B3, PL",
+      "example": "B1"
+    },
+    "fte": {
+      "type": "number",
+      "description": "FTE Decimal value e.g. 1, 0.5 etc",
+      "example": 0.75
+    },
+    "unit": {
+      "type": "string",
+      "description": "The personnel area of the Inspector",
+      "example": "Operations"
+    },
+    "service": {
+      "type": "string",
+      "description": "The personnel sub area of the Inspector",
+      "example": "Planning and Environmental Appeals Service"
+    },
+    "group": {
+      "type": "string",
+      "description": "Group of the Inspector",
+      "example": "Enforcement Groups"
+    },
+    "inspectorManager": {
+      "type": "string",
+      "description": "Name of the Inspector's manager.",
+      "example": "Dan Brown"
+    },
+    "validFrom": {
+      "type": ["string", "null"],
+      "description": "Date the Inspector record was first recorded.",
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"]
+    },
+    "address": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["addressLine1", "addressLine2", "townCity", "county", "postcode"],
+      "properties": {
+        "addressLine1": { "type": ["string", "null"] },
+        "addressLine2": { "type": ["string", "null"] },
+        "townCity": { "type": ["string", "null"] },
+        "county": { "type": ["string", "null"] },
+        "postcode": { "type": ["string", "null"] }
+      }
+    },
+    "specialisms": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/specialism"
+      }
+    }
+  },
+  "$defs": {
+    "specialism": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["name", "proficiency", "validFrom"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Working above band is stored as a specialism",
+          "example": "S62A Casework Major"
+        },
+        "proficiency": {
+          "type": ["string", "null"],
+          "description": "trained or in-training",
+          "example": "trained"
+        },
+        "validFrom": {
+          "type": ["string", "null"],
+          "description": "Date training started or date training was completed.",
+          "format": "date-time",
+          "examples": ["2023-07-27T20:30:00.000Z"]
+        }
+      }
     }
   }
 }

package/src/schemas.d.ts

@@ -2754,13 +2754,21 @@ export interface NsipSubscription {
 }
 
 /**
- * Inspector attributes as per Horizon. This will be extended with SAP/Entra data
+ * Inspector Details originating from Horizon, SAP HR and Entra.
  */
 export interface PINSInspector {
+  /**
+   * EntraID of the Inspector if available in ODW.
+   */
+  entraId: string | null;
+  /**
+   * SAPID of the Inspector if available in ODW.
+   */
+  sapId: string | null;
   /**
    * The PINS-generated unique horizon ID
    */
-  horizonId: string;
+  horizonId?: string;
   /**
    * The first name of the inspector
    */
@@ -2790,9 +2798,61 @@ export interface PINSInspector {
    */
   qualifications?: string | null;
   /**
-   * The email address of the inspector
+   * PINS Email address for the Inspector
    */
   email: string | null;
+  /**
+   * Grades as a coded value e.g. B1, B2, B3, FTC-B1, FTC-B2, FTC-B3, PL
+   */
+  grade: string;
+  /**
+   * FTE Decimal value e.g. 1, 0.5 etc
+   */
+  fte: number;
+  /**
+   * The personnel area of the Inspector
+   */
+  unit: string;
+  /**
+   * The personnel sub area of the Inspector
+   */
+  service: string;
+  /**
+   * Group of the Inspector
+   */
+  group: string;
+  /**
+   * Name of the Inspector's manager.
+   */
+  inspectorManager: string;
+  /**
+   * Date the Inspector record was first recorded.
+   */
+  validFrom?: string | null;
+  address: {
+    addressLine1: string | null;
+    addressLine2: string | null;
+    townCity: string | null;
+    county: string | null;
+    postcode: string | null;
+    [k: string]: unknown;
+  };
+  specialisms: Specialism[];
+  [k: string]: unknown;
+}
+export interface Specialism {
+  /**
+   * Working above band is stored as a specialism
+   */
+  name: string;
+  /**
+   * trained or in-training
+   */
+  proficiency: string | null;
+  /**
+   * Date training started or date training was completed.
+   */
+  validFrom: string | null;
   [k: string]: unknown;
 }