Replacement Parts

Find replacement parts for a specific part. Use a Part ID (UUID) to list replacements.

Endpoint

{{base_url}}/gateway/{{partner}}/parts/{{part}}/replacements

Example

URL

List replacements for part with UUID 9128A53F-A35F-40D4-9B6C-62A939AB1234

https://test.hub.bluontoolbox.com/uat/gateway/partner123/parts/9128A53F-A35F-40D4-9B6C-62A939AB1234/replacements

Curl

curl -X 'GET' \
  'https://test.hub.bluontoolbox.com/uat/gateway/partner123/parts/9128A53F-A35F-40D4-9B6C-62A939AB1234/replacements' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer [YOUR TOKEN]' \
  -H 'X-CSRF-TOKEN: '

Response

(Truncated for brevity - showing first 2 replacement parts)

{
  "data": [
    {
      "id": "FAFBB0A2-FBC6-46EC-8BAE-5BB59EED4BA0",
      "type": "single",
      "note": "Exact replacement per the manufacturer. (E)\nCOND MOTOR 1 HP, 1 SP, 230V",
      "score": 3,
      "score_detail": "Exact Replacement",
      "details": {
        "id": "055113EF-FDD7-4E84-8062-FC9D0658769C",
        "number": "0131M00040",
        "type": "motor",
        "subtype": "condenser_motor",
        "description": null,
        "brand": "Daikin",
        "image": {
          "id": "AC9C8DCA-EB74-4124-A8E0-AD98D83E2263",
          "url": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/parts/image/f722f07d-20eb-41f3-8e58-2df7a2b039a7/parts/image/0131m00040s_goodman-1.png",
          "conversions": []
        },
        "subcategory": "Condenser Motor 1HP 1110RPM 208-230V 1PH",
        "mfg_type": "oem",
        "updated_at": "2025-06-11 17:25:21",
        "specifications": {
          "voltage": "208-230V",
          "ph": "1PH",
          "rpm": "1110RPM",
          "output_hp": "1HP"
        },
        "replacements_count": 8,
        "replacements_aftermarket_count": 0
      }
    },
    {
      "id": "93E247B3-5CA3-44B5-B878-80182C3309F3",
      "type": "single",
      "note": "Exact replacement per the manufacturer. (E)\nMOTOR 1HP 1SP 230V",
      "score": 3,
      "score_detail": "Exact Replacement",
      "details": {
        "id": "E905FAE9-53B6-4E9F-8436-EB335E6F3447",
        "number": "0131M00040S",
        "type": "motor",
        "subtype": "condenser_motor",
        "description": null,
        "brand": "Daikin",
        "image": {
          "id": "AABCAA9A-2BCE-4512-A3A4-DAF3B0E8158D",
          "url": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/parts/image/b0906292-c684-4314-abb2-a7e02faa5f3a/parts/image/Uni_Geary29270.jpg",
          "conversions": []
        },
        "subcategory": "Condenser Motor 1HP 1110RPM 208-230V 1PH CW",
        "mfg_type": "oem",
        "updated_at": "2025-06-11 17:25:21",
        "specifications": {
          "voltage": "208-230V",
          "ph": "1PH",
          "rpm": "1110RPM",
          "output_hp": "1HP",
          "rotation": "CW"
        },
        "replacements_count": 8,
        "replacements_aftermarket_count": 0
      }
    }
  ],
  "links": {
    "first": "https://test.hub.bluontoolbox.com/uat/gateway/bluon/parts/9128A53F-A35F-40D4-9B6C-62A939AB1234/replacements?page=1",
    "last": "https://test.hub.bluontoolbox.com/uat/gateway/bluon/parts/9128A53F-A35F-40D4-9B6C-62A939AB1234/replacements?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://test.hub.bluontoolbox.com/uat/gateway/bluon/parts/9128A53F-A35F-40D4-9B6C-62A939AB1234/replacements",
    "per_page": 15,
    "to": 8,
    "total": 8
  }
}

Parameters

Name	Type	Required	Description
`{partner}`	string (path)	Required	your partner slug
`{part}`	string (path)	Required	part UUID
`distributor`	string (query)	Optional	distributor UUID
`page`	integer (query)	Optional	results by page
`per_page`	integer (query)	Optional	results per page

Replacement Score

It's very common to have hundreds of replacement options for a single part. We include a replacement score to help your users determine the best replacement. This can also be used to filter results.

Score 3: Exact Replacement

OEM exact or direct replacement. Install with confidence.

Score 2: Good Match

Compatible alternative. Minor differences, check specifications.

Score 1: Caution

Functional replacement. May require modifications or adjustments.