Property Business API

The Property Business API allows software packages to create, retrieve, amend and delete data for a property business.

• UK Property (FHL & Non-FHL)
• Foreign Property (FHL & Non-FHL)
• Historic UK Property (FHL & Non-FHL)

Requirements

• Scala 3.5.x
• Java 21
• sbt 1.10.x
• Service Manager V2

Development Setup

Run the microservice from the console using: sbt run (starts on port 7798 by default)

Start the service manager profile:

sm2 -start MTDFB_PROPERTY_BUSINESS

Run Tests

Run unit tests: sbt test

Run integration tests: sbt it/test

View OpenAPI Specification (OAS) documentation

To view the OpenAPI documentation locally, ensure the API is running.

Start the api-documentation-frontend and api-definition services using the Service Manager profile:

sm2 -start DEVHUB_PREVIEW_OPENAPI

Then navigate to the preview page:

http://localhost:9680/api-documentation/docs/openapi/preview

Enter the specification URL using the appropriate port and API version:

http://localhost:7798/api/conf/6.0/application.yaml

Changelog

You can see our changelog here

Support and Reporting Issues

You can create a GitHub issue here

API Reference / Documentation

Available on the HMRC Developer Hub

License

This code is open source software licensed under the Apache 2.0 License