API v1

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.

Base URL · https://samsungspareparts.com/functions/publicApiAuth · none (read-only)Max · 100 records per request

Quick 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

resource=partsslug, category, device, status, limit, cursor

Part records with identifiers, compatibility, classification and verification provenance.

https://samsungspareparts.com/functions/publicApi?resource=parts&limit=10
resource=devicesslug, series, type, limit, cursor

Device records with model numbers, series and repair context.

https://samsungspareparts.com/functions/publicApi?resource=devices&series=Galaxy%20S%20Series&limit=10
resource=compatibilitypart, device, limit, cursor

Compatibility 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-bs938aby
resource=suppliersregion, country, b2b, consumer, shipping, limit, cursor

Supplier directory entries with region, trade and shipping attributes.

https://samsungspareparts.com/functions/publicApi?resource=suppliers&region=Europe&b2b=true
resource=categorieslimit

Component categories with the number of part records in each.

https://samsungspareparts.com/functions/publicApi?resource=categories
resource=searchq (minimum 2 characters), limit

Search parts, devices, suppliers and part numbers in one call.

https://samsungspareparts.com/functions/publicApi?resource=search&q=EB-BS938ABY

Response 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=v1 in 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 } }.

HTTPCodeMeaning
400missing_parameterA required parameter is absent, or q is shorter than 2 characters.
400invalid_parameterA parameter failed validation, for example limit outside 1–100.
400unknown_resourceThe resource name is not one of the six published resources.
400unsupported_versionThe version parameter names a version this API does not serve.
405method_not_allowedOnly GET is supported. The API is read-only.
429rate_limitedMore than 60 requests in one minute from the same address.
500internal_errorThe 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.