{"openapi":"3.1.0","info":{"title":"CPSC recall evidence prototype","version":"0.1.0","description":"Independent source-linked recall candidates. Narrow corpus, no safety certification. Free research pilot; payments not connected."},"servers":[{"url":"https://merchant-policy-data.merchant-policy-data.workers.dev"}],"paths":{"/v1/trial-keys":{"post":{"operationId":"createFreeTrialKey","description":"No email/payment/catalog upload. Daily key and request caps apply. Store the returned key securely; it is shown once.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"channel":{"type":"string","enum":["direct","docs","example","search","mcp_registry"]}}}}}},"responses":{"201":{"description":"Private trial key shown once; never cache, publish or log it.","content":{"application/json":{"schema":{"type":"object","required":["api_key","expires_at","limits","chargeable"],"properties":{"api_key":{"type":"string","pattern":"^mpd_[a-f0-9]{64}$","readOnly":true},"expires_at":{"type":"string","format":"date-time"},"limits":{"type":"object","properties":{"requests_per_day":{"type":"integer","const":100},"requests_per_minute":{"type":"integer","const":10},"global_requests_per_day":{"type":"integer","const":2000},"keys_per_ip_per_day":{"type":"integer","const":2},"global_keys_per_day":{"type":"integer","const":50},"valid_days":{"type":"integer","const":30}}},"chargeable":{"const":false},"scope":{"const":"recall_candidates_only"},"payment_collection":{"const":"not_connected"}}}}}},"429":{"description":"Daily signup cap reached"}}}},"/v1/trial-keys/revoke":{"post":{"operationId":"revokeTrialKey","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Key revoked immediately"}}}},"/v1/recalls/coverage":{"get":{"operationId":"recallCoverage","responses":{"200":{"description":"Free research evidence. A no-match result never establishes that a product is safe.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok","candidates_found","no_candidates_in_scope","source_unavailable","stale"]},"product_safety":{"const":"unknown"},"chargeable":{"const":false},"records":{"type":"array","items":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}},"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"candidates":{"type":"array","items":{"type":"object","properties":{"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"match_kind":{"type":"string","enum":["identifier_candidate","text_candidate"]},"match_signals":{"type":"array","items":{"type":"string"}},"requires_notice_review":{"const":true}}}},"coverage":{"type":"object","properties":{"scope_complete":{"const":false},"announced_from":{"type":["string","null"]},"announced_through":{"type":["string","null"]},"checked_at":{"type":["string","null"]},"fresh_until":{"type":["string","null"]}}}}}}}}}}},"/v1/recalls/records":{"get":{"operationId":"listRecallRecords","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":250}}],"responses":{"200":{"description":"Free research evidence. A no-match result never establishes that a product is safe.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok","candidates_found","no_candidates_in_scope","source_unavailable","stale"]},"product_safety":{"const":"unknown"},"chargeable":{"const":false},"records":{"type":"array","items":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}},"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"candidates":{"type":"array","items":{"type":"object","properties":{"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"match_kind":{"type":"string","enum":["identifier_candidate","text_candidate"]},"match_signals":{"type":"array","items":{"type":"string"}},"requires_notice_review":{"const":true}}}},"coverage":{"type":"object","properties":{"scope_complete":{"const":false},"announced_from":{"type":["string","null"]},"announced_through":{"type":["string","null"]},"checked_at":{"type":["string","null"]},"fresh_until":{"type":["string","null"]}}}}}}}}}}},"/v1/recalls/records/{id}":{"get":{"operationId":"getRecallRecord","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^cpsc-[0-9]+$"}}],"responses":{"200":{"description":"Free research evidence. A no-match result never establishes that a product is safe.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok","candidates_found","no_candidates_in_scope","source_unavailable","stale"]},"product_safety":{"const":"unknown"},"chargeable":{"const":false},"records":{"type":"array","items":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}},"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"candidates":{"type":"array","items":{"type":"object","properties":{"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"match_kind":{"type":"string","enum":["identifier_candidate","text_candidate"]},"match_signals":{"type":"array","items":{"type":"string"}},"requires_notice_review":{"const":true}}}},"coverage":{"type":"object","properties":{"scope_complete":{"const":false},"announced_from":{"type":["string","null"]},"announced_through":{"type":["string","null"]},"checked_at":{"type":["string","null"]},"fresh_until":{"type":["string","null"]}}}}}}}},"404":{"description":"No such record in the current scoped corpus"}}}},"/v1/recalls/check":{"post":{"operationId":"findRecallCandidates","security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"gtin":{"type":"string","description":"Valid GTIN-8, UPC-A, EAN-13 or GTIN-14, including check digit. Keep leading zeroes."},"model":{"type":"string","minLength":2,"maxLength":80},"product_name":{"type":"string","minLength":3,"maxLength":160}},"minProperties":1}}}},"responses":{"200":{"description":"Free research evidence. A no-match result never establishes that a product is safe.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok","candidates_found","no_candidates_in_scope","source_unavailable","stale"]},"product_safety":{"const":"unknown"},"chargeable":{"const":false},"records":{"type":"array","items":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}},"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"candidates":{"type":"array","items":{"type":"object","properties":{"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"match_kind":{"type":"string","enum":["identifier_candidate","text_candidate"]},"match_signals":{"type":"array","items":{"type":"string"}},"requires_notice_review":{"const":true}}}},"coverage":{"type":"object","properties":{"scope_complete":{"const":false},"announced_from":{"type":["string","null"]},"announced_through":{"type":["string","null"]},"checked_at":{"type":["string","null"]},"fresh_until":{"type":["string","null"]}}}}}}}},"400":{"description":"Invalid field or identifier"},"401":{"description":"API key required"}}}},"/v1/recalls/changes":{"get":{"operationId":"recallChanges","parameters":[{"name":"after","in":"query","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Free research evidence. A no-match result never establishes that a product is safe.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok","candidates_found","no_candidates_in_scope","source_unavailable","stale"]},"product_safety":{"const":"unknown"},"chargeable":{"const":false},"records":{"type":"array","items":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}},"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"candidates":{"type":"array","items":{"type":"object","properties":{"record":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CPSC recall evidence record","description":"Bounded source evidence. Missing values and text candidates do not determine product safety, lot eligibility or remedy entitlement.","type":"object","additionalProperties":false,"required":["schema_version","normalizer_version","id","agency","jurisdiction","agency_record_id","recall_number","title","description","announced_on","source_published_on","affected_products","identifiers","organizations","retailer_scope_text","manufacturing_countries","hazards","incident_reports","remedies","remedy_options","coverage","quality","evidence","disclaimer","version"],"properties":{"schema_version":{"const":"1.0"},"normalizer_version":{"const":"cpsc-structured-2"},"id":{"type":"string","pattern":"^cpsc-[0-9]+$"},"agency":{"const":"CPSC"},"jurisdiction":{"const":"US"},"agency_record_id":{"type":"string"},"recall_number":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"announced_on":{"type":"string","format":"date"},"source_published_on":{"type":"string","format":"date"},"affected_products":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","description","model_raw","model_identifier","category","agency_category_id","units_affected_raw"],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"model_raw":{"type":["string","null"]},"model_identifier":{"type":["string","null"]},"category":{"type":["string","null"]},"agency_category_id":{"type":["string","null"]},"units_affected_raw":{"type":["string","null"]}}}},"identifiers":{"type":"object","additionalProperties":false,"required":["gtins","unparsed_or_invalid_upc_values"],"properties":{"gtins":{"type":"array","items":{"type":"string","pattern":"^[0-9]{14}$"}},"unparsed_or_invalid_upc_values":{"type":"array","items":{"type":"string"}}}},"organizations":{"type":"object","additionalProperties":false,"required":["manufacturers","importers","distributors"],"properties":{"manufacturers":{"type":"array","items":{"type":"string"}},"importers":{"type":"array","items":{"type":"string"}},"distributors":{"type":"array","items":{"type":"string"}}}},"retailer_scope_text":{"type":"array","items":{"type":"string"}},"manufacturing_countries":{"type":"array","items":{"type":"string"}},"hazards":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","agency_type","agency_type_id"],"properties":{"description":{"type":["string","null"]},"agency_type":{"type":["string","null"]},"agency_type_id":{"type":["string","null"]}}}},"incident_reports":{"type":"array","items":{"type":"string"}},"remedies":{"type":"array","items":{"type":"string"}},"remedy_options":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["lot_or_serial_scope","unit_eligibility","product_safety"],"properties":{"lot_or_serial_scope":{"const":"unparsed_notice_text"},"unit_eligibility":{"const":"not_determined"},"product_safety":{"const":"unknown"}}},"quality":{"type":"object","additionalProperties":false,"required":["missing_model","missing_gtin","missing_structured_gtin","text_interpretation","units_count_interpretation"],"properties":{"missing_model":{"type":"boolean"},"missing_gtin":{"type":"boolean"},"missing_structured_gtin":{"type":"boolean"},"text_interpretation":{"const":"labelled_upc_only"},"units_count_interpretation":{"const":"none"}}},"evidence":{"type":"object","additionalProperties":false,"required":["source_url","source_record_hash","rights_evidence_hash","license_url","attribution","field_pointers","extractions"],"properties":{"source_url":{"type":"string","format":"uri"},"source_record_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rights_evidence_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"license_url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"field_pointers":{"type":"object","additionalProperties":{"type":"string"}},"extractions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["target_field","value","json_pointer","start_utf16","end_utf16","source_text","method"],"properties":{"target_field":{"const":"identifiers.gtins"},"value":{"type":"string","pattern":"^[0-9]{14}$"},"json_pointer":{"type":"string"},"start_utf16":{"type":"integer","minimum":0},"end_utf16":{"type":"integer","minimum":0},"source_text":{"type":"string"},"method":{"const":"labelled_upc_with_valid_check_digit_v1"}}}}}},"disclaimer":{"type":"string"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"match_kind":{"type":"string","enum":["identifier_candidate","text_candidate"]},"match_signals":{"type":"array","items":{"type":"string"}},"requires_notice_review":{"const":true}}}},"coverage":{"type":"object","properties":{"scope_complete":{"const":false},"announced_from":{"type":["string","null"]},"announced_through":{"type":["string","null"]},"checked_at":{"type":["string","null"]},"fresh_until":{"type":["string","null"]}}}}}}}}}}}},"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer"}}}}