search_eprel_products

Search the queried source by model identifier, registration number, or supplier/brand + product group. Returns CANDIDATE public records with deterministic match kinds and visible ambiguity: 'exact_public_record' / 'possible_match' / 'multiple_matches' / 'no_match_in_queried_source' — a no-match is never 'not registered'. Outage → 'unavailable'; unverified schema → 'source_schema_unverified'; stale → 'stale'. Answers come from the queried source at the stated retrieval time: the official EPREL Public API in live mode, or a clearly-labelled synthetic fixture in dev/test — provenance.sourceAuthority names which. Supplier-declared data only; Jithox verifies nothing. Preflight evidence only — never a conformity, CE, GPSR, safety or market-access determination.

Parameters4

modelIdentifier	string	optional	The supplier's model identifier to search for.
supplierOrBrand	string	optional	Supplier or trade brand to narrow the search.
productGroup	string	optional	Product group to narrow the search (must be covered by the queried source). The official live source searches ONE group at a time: text searches (model/brand) REQUIRE it; registration-number lookups do not.
registrationNumber	string	optional	A public registration number, when known.

Raw schema

{
  "type": "object",
  "properties": {
    "modelIdentifier": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "The supplier's model identifier to search for."
    },
    "supplierOrBrand": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Supplier or trade brand to narrow the search."
    },
    "productGroup": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Product group to narrow the search (must be covered by the queried source). The official live source searches ONE group at a time: text searches (model/brand) REQUIRE it; registration-number lookups do not."
    },
    "registrationNumber": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "A public registration number, when known."
    }
  },
  "additionalProperties": false
}

get_eprel_product_record

Structure ONE public record by its public record identifier: declared supplier/brand, product group, declared public fields, documents, missing fields, provenance and freshness. 'exact_public_record' / 'no_match_in_queried_source' / 'unavailable'. Answers come from the queried source at the stated retrieval time: the official EPREL Public API in live mode, or a clearly-labelled synthetic fixture in dev/test — provenance.sourceAuthority names which. Supplier-declared data only; Jithox verifies nothing. Preflight evidence only — never a conformity, CE, GPSR, safety or market-access determination.

Parameters1

publicRecordId

string

optional

The public record identifier (from a prior search candidate).

Raw schema

{
  "type": "object",
  "properties": {
    "publicRecordId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "The public record identifier (from a prior search candidate)."
    }
  },
  "additionalProperties": false
}

get_eprel_energy_label_data

Structure the supplier-DECLARED energy-label / product-sheet data for one public record. The result states supplierDeclared=true and independentlyVerifiedByJithox=false explicitly — nothing is independently verified. Answers come from the queried source at the stated retrieval time: the official EPREL Public API in live mode, or a clearly-labelled synthetic fixture in dev/test — provenance.sourceAuthority names which. Preflight evidence only — never a conformity, CE, GPSR, safety or market-access determination.

Parameters1

publicRecordId

string

optional

The public record identifier whose declared label data to return.

Raw schema

{
  "type": "object",
  "properties": {
    "publicRecordId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "The public record identifier whose declared label data to return."
    }
  },
  "additionalProperties": false
}

compare_eprel_product_metrics

Compare two or more COMPATIBLE records on their COMMON supplier-declared metrics — a value table only. Cross-product-group comparison fails safely as 'incompatible_comparison'; no 'best product', no ranking, no buying advice. Answers come from the queried source at the stated retrieval time: the official EPREL Public API in live mode, or a clearly-labelled synthetic fixture in dev/test — provenance.sourceAuthority names which. Supplier-declared data only; Jithox verifies nothing.

Parameters2

publicRecordIds	array	optional	Public record identifiers to compare; a comparison needs at least 2 (fewer returns 'insufficient_identifiers'), up to 5.
metricKeys	array	optional	Optional metric keys to restrict the comparison to.

Raw schema

{
  "type": "object",
  "properties": {
    "publicRecordIds": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "Public record identifiers to compare; a comparison needs at least 2 (fewer returns 'insufficient_identifiers'), up to 5."
    },
    "metricKeys": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 60
      },
      "maxItems": 10,
      "description": "Optional metric keys to restrict the comparison to."
    }
  },
  "additionalProperties": false
}

prepare_energy_label_preflight_receipt

Bundle the preflight lookups into one idempotent Ed25519-signed receipt committing to the FINGERPRINTED inputs, record references, sources, freshness and decision states — provable evidence of WHAT was looked up and WHEN. Attests the lookups, never a registration, conformity or market-access outcome. Preflight evidence only — never a conformity, CE, GPSR, safety or market-access determination.

Parameters2

bundle	object	required	The preflight results to attest (fingerprinted inputs, sources, decision states — no raw query values).
createdAt	string	required	ISO timestamp the bundle was assembled.

Raw schema

{
  "type": "object",
  "properties": {
    "bundle": {
      "type": "object",
      "description": "The preflight results to attest (fingerprinted inputs, sources, decision states — no raw query values)."
    },
    "createdAt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "ISO timestamp the bundle was assembled."
    }
  },
  "required": [
    "bundle",
    "createdAt"
  ],
  "additionalProperties": false
}

Jithox EU Energy Label Preflight

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_eprel_products

get_eprel_product_record

get_eprel_energy_label_data

compare_eprel_product_metrics

prepare_energy_label_preflight_receipt

Install

Remote endpoint