bSDD icon indicating copy to clipboard operation
bSDD copied to clipboard

buildingSMART Data Dictionary repo

Official repository by buildingSMART International

bSDD logo

The buildingSMART Data Dictionary (bSDD) is an online service for hosting data dictionaries containing classifications, their properties, allowed values, units, translations, etc. It provides a standardized workflow to improve data quality and information consistency.

At the heart of bSDD is a database, where all dictionaries can be related to each other. The main way to access the bSDD is through its APIs (Application Programming Interfaces). This is how most BIM software and other apps can use the data stored in the bSDD. Apart from that, there is the bSDD Search page, where people can look up the content. Authors can publish content to bSDD through the API or the Management Portal. To be able to upload, please fill out the organisation registration form.

More info on https://www.buildingsmart.org/users/services/buildingsmart-data-dictionary/

bSDD diagram

📢 We inform about planned and recently implemented bSDD updates in this forum topic: bSDD Tech Updates.

Instructions

For developers 👩‍💻

  • The API URL (not a readable website): https://api.bsdd.buildingsmart.org/
  • API documentation on Swagger: https://app.swaggerhub.com/apis/buildingSMART/Dictionaries/v1

We also provide a Test environment where the latest features are rolled out first and tested. If you want to check it out, here are the equivalent pages:

  • Test Search in the (test) bSDD: https://search-test.bsdd.buildingsmart.org/
  • Test upload data to the (test) database: https://manage-test.bsdd.buildingsmart.org/
  • Test environment API documentation on Swagger: https://test.bsdd.buildingsmart.org/swagger/
  • Test environment GraphQL UI for getting data via GraphQL in the UI: GraphQL UI

Examples, use-cases, tools and presentations

Contact us

Need help? Got suggestions? Send an email to [email protected]

or contact the bSDD product manager: Artur Tomczak [email protected]