Get Makes

GET http://api.boomandbucket.com/taxonomyservice/taxonomy/makes

This endpoint retrieves a list of equipment manufacturers (makes) and detailed taxonomy information.

Response Format

The response is an array of objects, each representing a manufacturer. Each object contains the following fields:

• id (string): A unique identifier for the manufacturer.
• name (string): The manufacturer's name in uppercase.
• preferredDisplayName (string): The manufacturer's name in a more display-friendly format.
• taxonomyVerificationStatus (integer): An integer representing the verification status of the taxonomy item.
• url (string): The manufacturer's official website URL.

Taxonomy Verification Status

The taxonomyVerificationStatus field is an enumeration representing the verification status, defined as follows:

• 0: None - Initial default state, no verification done.
• 1: Unverified - The item has not been verified.

• 2: SystemProcessed - This status indicates that the information has been sorted and validated using an automated, non-expert system. It relies on both algorithmic and human assessment rather than specialized, expert analysis.

• 4: VerifiedByExpert - Verified internally by heavy equipment expert.

• 8: VerifiedByAI - Verified using AI.

The taxonomyVerificationStatus field uses a bitwise representation to allow for combinations of different verification states. For example, a value of 3 (binary 0011) would indicate that the item is both Unverified (1) and SystemProcessed (2).

Sample Response

 [
  {
    "id": "66ad635f-2d5f-4b78-8b13-69c8cd3b5d1b",
    "name": "CATERPILLAR",
    "preferredDisplayName": "Caterpillar",
    "taxonomyVerificationStatus": 2,
    "url": "https://www.caterpillar.com"
  },
  {
    "id": "1bdaede2-16b6-4546-a8dd-2a47885f2d66",
    "name": "JOHN DEERE",
    "preferredDisplayName": "John Deere",
    "taxonomyVerificationStatus": 2,
    "url": "https://www.deere.com/en/index.html"
  }
]

RESPONSES

status: OK

[{"id":"431ca18a-7655-4f40-bb45-2fcbd12d1caf","name":"1954 MFG","preferredDisplayName":"1954 Mfg","taxonomyVerificationStatus":2,"url":"https://www.1954manufacturing.com/"},{"id":"6441f789-61d2-427a-b00e-4010b172dc05","name":"2C MACHINERY","preferredDisplayName":"2c Machinery","taxonomyVerificationStatus":2,"url":"https://www.2cmachines.com/"},{"id":"4cae3163-649b-469f-8d3d-64fb43db099b","name":"4T MFG","preferredDisplayName":"4t Mfg","taxonomyVerificationStatus":2,"url":"https://www.4tmfg.com/"},{"id":"6ee43b47-5457-4474-95f1-85544ba160d5","name":"AAA TRAILERS","preferredDisplayName":"AAA Trailers","taxonomyVerificationStatus":2,"url":"https://www.aaatrailers.com.au/"},{"id":"09bd10fa-07aa-4621-8dd8-4548a0ebe41d","name":"AB","preferredDisplayName":"Ab","taxonomyVerificationStatus":2,"url":"https://abmfginc.ca/"},{"id":"06b5b51f-b1d2-4e0a-9476-e30c4c5eff81","name":"ABB","preferredDisplayName":"ABB","taxonomyVerificationStatus":2,"url":"https://global.abb/group/en"},{"id":"a8bccddc-fba2-472a-91a4-ab2d4c528af1","name":"ABCO","preferredDisplayName":"ABCO","taxonomyVerificationStatus":2,"url":"https://www.goabco.com/"}]