Open Equipment Taxonomy Alliance

Overview

The Open Equipment Taxonomy is a jointly developed program by members of the equipment software community. Equipment taxonomy is a basic infrastructure need for all digital service providers - it powers discovery, search, and interoperability between different software platforms. The project was begun by Boom and Bucket using over 2.32M data points, which were categorized and aliased with a combination of AI and human review. Members of the Alliance contribute make-model data to be categorized and aliased for use by all. The Taxonomy currently has over 70,000 make-model combinations taxonomized and is growing daily.


How it works

The Open Equipment Taxonomy is available to the general public. It can be downloaded in CSV format (updated monthly) or in its most up-to-date JSON format via an open API endpoint (coming soon). Companies with unstructured data sets (equipment management software providers, marketplaces, OEMs, etc.) can submit make-model combinations for categorization and aliasing using the sample format provided. That data will then be incorporated into the equipment taxonomy for general use.


How to join

If you’d like to join the alliance, simply submit your unique make-model combinations in the format below along with any questions to partnerships@boomandbucket.com.

Participants

  • Boom and Bucket
  • Procore
  • Quipli
  • Tenna
  • Gearflow

Heavy Equipment Taxonomy

  • NAICS

  • SIC

  • Used For

  • Taxonomized Categories

  • Taxonomized Subcategories

  • Taxonomized Makes

  • Taxonomized Models


NAICS

Purpose:

Represents an entry in the 2022 North American Industry Classification System (NAICS).

Context:

NAICS codes are used to classify business establishments by the type of economic activity in which they are engaged. This class specifically deals with the codes as per the 2022 NAICS standards, crucial for accurate industry classification in various business and economic contexts.

Columns

ID

int

A unique identifier object created from the NAICS code number.

NAICSCodeNumber

int

The actual numerical NAICS code.

SequenceNumber

int

An ordinal number representing the sequence of the code in the NAICS list.

Title (en_US)

string

The title of the NAICS code as used in the United States.

Description

string

Detailed description of what the NAICS code represents.

Used For IDs

int[]

Used to identify which equipment subcategories (and by proxy makes & models) that NAICS industry code use in their day to day business.

API Access

Why use an API?

Utilizing our API at /taxonomyservice/taxonomy/current provides an efficient solution for accessing the most current updates from the Open Equipment Taxonomy. This API offers real-time data, ensuring users always have the latest taxonomy information without needing to wait for monthly CSV updates. It's ideal for companies that require immediate access to updated make-model data, enhancing their capabilities in discovery, search, and interoperability across various digital platforms. By integrating directly with our API, users benefit from seamless and continuous updates, supporting better data management and decision-making in equipment software services.


    How to connect

    To access the Open Equipment Taxonomy via our API at /taxonomyservice/taxonomy/current, follow these steps to get started:

    Request Access:

    Receive Your API Key:

    Upon approval, we will issue you an API key. This key is essential for authenticating your requests.

    Making API Requests:

    Use the issued API key to authenticate your requests. You can include this key in your requests in one of two ways:

    • As a header: X-API-KEY: <your_api_key>
    • As a query parameter: /taxonomyservice/taxonomy/current?X-API-KEY=<your_api_key>

    Data Retrieval:

    Access the endpoint to retrieve the latest taxonomy data. The data is updated hourly and cached to ensure quick and reliable access.

    Integrate and Use:

    Integrate the API responses into your application or system to utilize the up-to-date taxonomy data for your operational needs.

    By following these steps, you can connect to our API to fetch the most current data available, supporting your needs for accurate and timely information in your equipment management and service offerings.

    {
      "naics2022Codes": [
        {
          "sequenceNumber": 0,
          "naicsCodeNumber": 0,
          "usTitle": "string",
          "description": "string",
          "id": {
            "value": 0
          },
          "isTwoDigitCode": true,
          "isThreeDigitCode": true,
          "isFourDigitCode": true,
          "isFiveDigitCode": true,
          "isSixDigitCode": true,
          "digitCount": 0,
          "usedForIds": [
            {
              "value": 0
            }
          ]
        }
      ],
      "sicCodes": [
        {
          "sicCodeNumber": 0,
          "description": "string",
          "usedForIds": [
            {
              "value": 0
            }
          ],
          "id": {
            "value": 0
          },
          "isTwoDigitCode": true,
          "isFourDigitCode": true,
          "code": "string"
        }
      ],
      "usedFor": [
        {
          "id": {
            "value": 0
          },
          "title": "string",
          "description": "string",
          "sicCodeIds": [
            {
              "value": 0
            }
          ],
          "naics2022CodeIds": [
            {
              "value": 0
            }
          ]
        }
      ],
      "taxonomizedCategories": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "nameTranslations": [
            {
              "languageId": 0,
              "languageShortCode": "string",
              "text": "string",
              "description": "string"
            }
          ],
          "slug": "string",
          "subCategoryIds": [
            "string"
          ]
        }
      ],
      "taxonomizedSubcategories": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "categoryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": {
            "translations": [
              {
                "languageId": 0,
                "languageShortCode": "string",
                "text": "string",
                "description": "string"
              }
            ]
          },
          "slug": "string",
          "marketplaceCategory": "string",
          "meterTypeNameForValuation": "string",
          "usedForIds": [
            0
          ],
          "specKeys": [
            {
              "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
              "taxonomizedSubCategoryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
              "name": {
                "translations": [
                  {
                    "languageId": 0,
                    "languageShortCode": "string",
                    "text": "string",
                    "description": "string"
                  }
                ]
              },
              "slug": "string",
              "description": {
                "translations": [
                  {
                    "languageId": 0,
                    "languageShortCode": "string",
                    "text": "string",
                    "description": "string"
                  }
                ]
              },
              "unitType": "string",
              "isNumericDataType": true
            }
          ]
        }
      ],
      "taxonomizedMakes": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "preferredDisplayName": "string",
          "url": "string",
          "verificationStatus": 0,
          "makeAliases": [
            "string"
          ]
        }
      ],
      "taxonomizedSubcategorySpecKeys": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "taxonomizedSubCategoryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": {
            "translations": [
              {
                "languageId": 0,
                "languageShortCode": "string",
                "text": "string",
                "description": "string"
              }
            ]
          },
          "slug": "string",
          "description": {
            "translations": [
              {
                "languageId": 0,
                "languageShortCode": "string",
                "text": "string",
                "description": "string"
              }
            ]
          },
          "unitType": "string",
          "isNumericDataType": true
        }
      ],
      "taxonomizedModels": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "make": "string",
          "makeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "model": "string",
          "preferredDisplayName": "string",
          "yearsManufactured": [
            0
          ],
          "verificationStatus": 0,
          "taxonomySubcategoryIDs": [
            "string"
          ],
          "modelAliases": [
            "string"
          ]
        }
      ]
    }

    Downloads

    Taxonomy

    Apr 26, 2024

    Data model diagram

    Mock export

    Apr 9th, 2024