Public data API
A read-only JSON API over the parts registry: part numbers, compatibility, supplier evidence and verification provenance. No key is required, no private or administrative field is exposed, and every record carries its own verification status so you can judge it yourself.
https://samsungspareparts.com/functions/publicApiAuth · none (read-only)Max · 100 records per requestQuick start
Every request is a GET to the same endpoint with a resource parameter.
curl "https://samsungspareparts.com/functions/publicApi?resource=parts&limit=10"const res = await fetch("https://samsungspareparts.com/functions/publicApi?resource=parts&limit=10");
const { data, count, has_more, next_cursor } = await res.json();Resources
Part records with identifiers, compatibility, classification and verification provenance.
https://samsungspareparts.com/functions/publicApi?resource=parts&limit=10Device records with model numbers, series and repair context.
https://samsungspareparts.com/functions/publicApi?resource=devices&series=Galaxy%20S%20Series&limit=10Compatibility records linking a part to a device and model number, with verification status.
https://samsungspareparts.com/functions/publicApi?resource=compatibility&part=galaxy-s25-ultra-battery-eb-bs938abySupplier directory entries with region, trade and shipping attributes.
https://samsungspareparts.com/functions/publicApi?resource=suppliers®ion=Europe&b2b=trueComponent categories with the number of part records in each.
https://samsungspareparts.com/functions/publicApi?resource=categoriesSearch parts, devices, suppliers and part numbers in one call.
https://samsungspareparts.com/functions/publicApi?resource=search&q=EB-BS938ABYResponse shape
Lists are paginated. Pass cursor from the previous response whilehas_more is true.
{
"api": { "version": "v1", "resource": "parts", "limit": 1 },
"count": 1,
"has_more": true,
"next_cursor": "MjU=",
"data": [
{
"slug": "galaxy-s25-ultra-battery-eb-bs938aby",
"name": "Battery EB-BS938ABY",
"category": "Batteries",
"part_number": "EB-BS938ABY",
"compatible_model_numbers": ["SM-S938B", "SM-S938U"],
"verification_status": "Unverified",
"last_checked": null,
"source_url": null,
"supplier_evidence": {
"exact_part_supplier_count": 3,
"stock_availability_verified": false,
"last_checked": "2026-09-14",
"basis": "Distinct suppliers publishing a listing for this exact part."
}
}
]
}Verification and evidence
verification_status is Verified, Reported or Unverified. A record is only ever Verified when a source reference and verification method are present on the record itself. Treat Unverified as "reported, not confirmed".
supplier_evidence.exact_part_supplier_count counts distinct suppliers with a recorded listing for that exact part. It is not category coverage and it is not stock.
stock_availability_verified is true only when a supplier listing carries an explicit stock status. When false, the part is listed by a supplier but current availability is unknown.
Limits, caching and versioning
- Maximum 100 records per request; the default is 25.
- Rate limited to 60 requests per minute per client address, enforced at the edge.
- Responses are cacheable: 5 minutes in the browser, 15 minutes at the edge.
- Pin
version=v1in integrations. v1 is stable; breaking changes ship as a new version. - Only whitelisted fields are returned. Commercial, administrative and internal fields are never exposed.
Error codes
Errors always return the shape { error: { code, message, status, version } }.
| HTTP | Code | Meaning |
|---|---|---|
| 400 | missing_parameter | A required parameter is absent, or q is shorter than 2 characters. |
| 400 | invalid_parameter | A parameter failed validation, for example limit outside 1–100. |
| 400 | unknown_resource | The resource name is not one of the six published resources. |
| 400 | unsupported_version | The version parameter names a version this API does not serve. |
| 405 | method_not_allowed | Only GET is supported. The API is read-only. |
| 429 | rate_limited | More than 60 requests in one minute from the same address. |
| 500 | internal_error | The request could not be completed. Retry later. |
Attribution and accuracy
SamsungSpareParts.com is independent and not affiliated with, endorsed by or authorised by Samsung Electronics Co., Ltd. Part and model identifiers are reproduced for identification purposes only. Records can be incomplete or superseded: confirm identifiers against the physical component before relying on them. Corrections are welcome through the contact form.
