Model Search
Search Bluon database for a model number string (can be exact or partial) to return matching results.
Endpoint
{{base_url}}/gateway/{{partner}}/oemsExample URL
Search for manuals for model 'GSX111'
https://test.hub.bluontoolbox.com/uat/gateway/bluon/oems?model=GSX111Example Curl
curl -X 'GET' \
'https://test.hub.bluontoolbox.com/uat/gateway/partner123/oems?model=GSX111' \
-H 'accept: application/json' \
-H 'Authorization: Bearer [YOUR_TOKEN]' \
-H 'X-CSRF-TOKEN: 'Example Response
{
"data": [
{
"id": "4700F488-63A8-43CE-9F73-49B7D59BE3BE",
"model": "GSX111203AA",
"model_notes": "10 Ton, R-410A",
"manuals_count": 3,
"logo": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/brands/logo/oDE0aq3BQ4KGBEJZHgmi_goodman.png",
"image": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/oems/unit_image/GM_GSX-2.PNG",
"system_type": "Condensing Unit",
"calling_groups": "Residential Condenser",
"updated_at": "2025-06-13T00:00:00.000000Z",
"functional_parts_count": 9,
"my_parts_count": 0,
"my_parts_replacements_count": 0,
"root_model": "GSX111203AA",
"brand_name": "Goodman",
"brand_image": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/brands/logo/oDE0aq3BQ4KGBEJZHgmi_goodman.png",
"series": {
"id": 4648,
"name": "GSX11",
"image": {
"id": "fcc115f1cd1557b779ad0af1405cf632",
"url": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/series/image/GM_GSX.PNG",
"conversions": []
}
},
"confidence_score": 0.91
},
{
"id": "22D87448-FD91-4692-B13D-47F0F5192A3E",
"model": "GSX111203AB",
"model_notes": "10 Ton, R-410A",
"manuals_count": 3,
"logo": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/brands/logo/oDE0aq3BQ4KGBEJZHgmi_goodman.png",
"image": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/oems/unit_image/GM_GSX-2.PNG",
"system_type": "Condensing Unit",
"calling_groups": "Residential Condenser",
"updated_at": "2025-06-13T00:00:00.000000Z",
"functional_parts_count": 9,
"my_parts_count": 0,
"my_parts_replacements_count": 0,
"root_model": "GSX111203AB",
"brand_name": "Goodman",
"brand_image": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/brands/logo/oDE0aq3BQ4KGBEJZHgmi_goodman.png",
"series": {
"id": 4648,
"name": "GSX11",
"image": {
"id": "fcc115f1cd1557b779ad0af1405cf632",
"url": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/series/image/GM_GSX.PNG",
"conversions": []
}
},
"confidence_score": 0.91
},
{
"id": "22570AA6-34A6-4AEF-A636-E71A1EE76821",
"model": "GSX111204AA",
"model_notes": "10 Ton, R-410A",
"manuals_count": 3,
"logo": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/brands/logo/oDE0aq3BQ4KGBEJZHgmi_goodman.png",
"image": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/oems/unit_image/GM_GSX-2.PNG",
"system_type": "Condensing Unit",
"calling_groups": "Residential Condenser",
"updated_at": "2025-06-13T00:00:00.000000Z",
"functional_parts_count": 9,
"my_parts_count": 0,
"my_parts_replacements_count": 0,
"root_model": "GSX111204AA",
"brand_name": "Goodman",
"brand_image": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/brands/logo/oDE0aq3BQ4KGBEJZHgmi_goodman.png",
"series": {
"id": 4648,
"name": "GSX11",
"image": {
"id": "fcc115f1cd1557b779ad0af1405cf632",
"url": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/series/image/GM_GSX.PNG",
"conversions": []
}
},
"confidence_score": 0.91
},
{
"id": "20E06884-C746-475E-975E-989FDF837B75",
"model": "GSX111204AB",
"model_notes": "10 Ton, R-410A",
"manuals_count": 3,
"logo": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/brands/logo/oDE0aq3BQ4KGBEJZHgmi_goodman.png",
"image": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/oems/unit_image/GM_GSX-2.PNG",
"system_type": "Condensing Unit",
"calling_groups": "Residential Condenser",
"updated_at": "2025-06-13T00:00:00.000000Z",
"functional_parts_count": 9,
"my_parts_count": 0,
"my_parts_replacements_count": 0,
"root_model": "GSX111204AB",
"brand_name": "Goodman",
"brand_image": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/brands/logo/oDE0aq3BQ4KGBEJZHgmi_goodman.png",
"series": {
"id": 4648,
"name": "GSX11",
"image": {
"id": "fcc115f1cd1557b779ad0af1405cf632",
"url": "https://assets-bluon-prod.sfo3.cdn.digitaloceanspaces.com/series/image/GM_GSX.PNG",
"conversions": []
}
},
"confidence_score": 0.91
}
],
"links": {
"first": "https://test.hub.bluontoolbox.com/uat/gateway/bluon/oems?query=GSX111&model=GSX111&page=1",
"last": "https://test.hub.bluontoolbox.com/uat/gateway/bluon/oems?query=GSX111&model=GSX111&page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://test.hub.bluontoolbox.com/uat/gateway/bluon/oems?query=GSX111&model=GSX111&page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "https://test.hub.bluontoolbox.com/uat/gateway/bluon/oems",
"per_page": 15,
"to": 4,
"total": 4,
"search_term": "GSX111"
}
}Parameters
| Name | Type | Required | Description |
|---|---|---|---|
{partner} | string (path) | required | your partner slug |
model | string (query) | required | model number string |
brand | string (query) | optional | mfg brand |
page | integer (query) | optional | results by page |
per_page | integer (query) | optional | results per page |
Note
Typically at this stage you want to get the 'id' for a model (the UUID) which is used in subsequent endpoints to fetch details, manuals, and parts lists for that specific model.