{"openapi":"3.1.0","info":{"title":"PCB Capability Evidence API","version":"1.0.0","description":"Free public read-only preview. Documented supplier claims with citations and conditions; no factory qualification or live capacity claims. Text filters are not normalized numeric specification matching."},"servers":[{"url":"https://champion-pcb-capabilities.chipmoreno.chatgpt.site/api/v1"}],"security":[],"paths":{"/companies":{"get":{"summary":"Search companies","operationId":"Search_companies","parameters":[{"name":"query","in":"query","required":false,"description":"Case-insensitive company name or metadata search.","schema":{"type":"string","description":"Case-insensitive company name or metadata search.","minLength":0,"maxLength":200}},{"name":"headquarters_country","in":"query","required":false,"description":"Exact headquarters country, not manufacturing geography.","schema":{"type":"string","description":"Exact headquarters country, not manufacturing geography.","minLength":0,"maxLength":200}},{"name":"capability_query","in":"query","required":false,"description":"Search within individual documented claim records. Matching examples keep their original conditions.","schema":{"type":"string","description":"Search within individual documented claim records. Matching examples keep their original conditions.","minLength":0,"maxLength":200}},{"name":"limit","in":"query","required":false,"description":"Records per page (1–100).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Records per page (1–100)."}},{"name":"offset","in":"query","required":false,"description":"Zero-based pagination offset.","schema":{"type":"integer","minimum":0,"maximum":1000000,"default":0,"description":"Zero-based pagination offset."}}],"responses":{"200":{"description":"Public source-linked research records.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Company"}},"meta":{"type":"object","description":"Version, dataset counts, snapshot time and evidence caveat."},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","meta","pagination"]}}}},"400":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"404":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"405":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"503":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}}}}},"/companies/{company}":{"get":{"summary":"Get company","operationId":"Get_company","parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"string"},"description":"Company slug or UUID; claim routes use the stable claim record ID."}],"responses":{"200":{"description":"Public source-linked research records.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Company"},"meta":{"type":"object","description":"Version, dataset counts, snapshot time and evidence caveat."}},"required":["data","meta"]}}}},"400":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"404":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"405":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"503":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}}}}},"/companies/{company}/capabilities":{"get":{"summary":"Get company capabilities","operationId":"Get_company_capabilities","parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"string"},"description":"Company slug or UUID; claim routes use the stable claim record ID."},{"name":"query","in":"query","required":false,"description":"Case-insensitive search within each claim.","schema":{"type":"string","description":"Case-insensitive search within each claim.","minLength":0,"maxLength":200}},{"name":"field","in":"query","required":false,"description":"Field label substring. Use list_capability_fields to discover available labels.","schema":{"type":"string","description":"Field label substring. Use list_capability_fields to discover available labels.","minLength":0,"maxLength":200}},{"name":"production_tier","in":"query","required":false,"description":"Production tier substring.","schema":{"type":"string","description":"Production tier substring.","minLength":0,"maxLength":200}},{"name":"material","in":"query","required":false,"description":"Material/product substring.","schema":{"type":"string","description":"Material/product substring.","minLength":0,"maxLength":200}},{"name":"factory","in":"query","required":false,"description":"Factory/entity substring.","schema":{"type":"string","description":"Factory/entity substring.","minLength":0,"maxLength":200}},{"name":"evidence_status","in":"query","required":false,"description":"Exact evidence-status label.","schema":{"type":"string","description":"Exact evidence-status label.","minLength":0,"maxLength":200}},{"name":"limit","in":"query","required":false,"description":"Records per page (1–100).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Records per page (1–100)."}},{"name":"offset","in":"query","required":false,"description":"Zero-based pagination offset.","schema":{"type":"integer","minimum":0,"maximum":1000000,"default":0,"description":"Zero-based pagination offset."}}],"responses":{"200":{"description":"Public source-linked research records.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Claim"}},"meta":{"type":"object","description":"Version, dataset counts, snapshot time and evidence caveat."},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","meta","pagination"]}}}},"400":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"404":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"405":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"503":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}}}}},"/companies/{company}/sources":{"get":{"summary":"Get company sources","operationId":"Get_company_sources","parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"string"},"description":"Company slug or UUID; claim routes use the stable claim record ID."},{"name":"status","in":"query","required":false,"description":"Exact review-status label.","schema":{"type":"string","description":"Exact review-status label.","minLength":0,"maxLength":200}},{"name":"language","in":"query","required":false,"description":"Language substring.","schema":{"type":"string","description":"Language substring.","minLength":0,"maxLength":200}},{"name":"limit","in":"query","required":false,"description":"Records per page (1–100).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Records per page (1–100)."}},{"name":"offset","in":"query","required":false,"description":"Zero-based pagination offset.","schema":{"type":"integer","minimum":0,"maximum":1000000,"default":0,"description":"Zero-based pagination offset."}}],"responses":{"200":{"description":"Public source-linked research records.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"meta":{"type":"object","description":"Version, dataset counts, snapshot time and evidence caveat."},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","meta","pagination"]}}}},"400":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"404":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"405":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"503":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}}}}},"/capabilities":{"get":{"summary":"Search all capabilities","operationId":"Search_all_capabilities","parameters":[{"name":"company","in":"query","required":false,"description":"Company slug or UUID.","schema":{"type":"string","description":"Company slug or UUID.","minLength":0,"maxLength":200}},{"name":"query","in":"query","required":false,"description":"Case-insensitive search within each claim.","schema":{"type":"string","description":"Case-insensitive search within each claim.","minLength":0,"maxLength":200}},{"name":"field","in":"query","required":false,"description":"Field label substring. Use list_capability_fields to discover available labels.","schema":{"type":"string","description":"Field label substring. Use list_capability_fields to discover available labels.","minLength":0,"maxLength":200}},{"name":"production_tier","in":"query","required":false,"description":"Production tier substring.","schema":{"type":"string","description":"Production tier substring.","minLength":0,"maxLength":200}},{"name":"material","in":"query","required":false,"description":"Material/product substring.","schema":{"type":"string","description":"Material/product substring.","minLength":0,"maxLength":200}},{"name":"factory","in":"query","required":false,"description":"Factory/entity substring.","schema":{"type":"string","description":"Factory/entity substring.","minLength":0,"maxLength":200}},{"name":"evidence_status","in":"query","required":false,"description":"Exact evidence-status label.","schema":{"type":"string","description":"Exact evidence-status label.","minLength":0,"maxLength":200}},{"name":"limit","in":"query","required":false,"description":"Records per page (1–100).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Records per page (1–100)."}},{"name":"offset","in":"query","required":false,"description":"Zero-based pagination offset.","schema":{"type":"integer","minimum":0,"maximum":1000000,"default":0,"description":"Zero-based pagination offset."}}],"responses":{"200":{"description":"Public source-linked research records.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Claim"}},"meta":{"type":"object","description":"Version, dataset counts, snapshot time and evidence caveat."},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","meta","pagination"]}}}},"400":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"404":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"405":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"503":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}}}}},"/claims/{claim}":{"get":{"summary":"Get claim evidence","operationId":"Get_claim_evidence","parameters":[{"name":"claim","in":"path","required":true,"schema":{"type":"string"},"description":"Company slug or UUID; claim routes use the stable claim record ID."}],"responses":{"200":{"description":"Public source-linked research records.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"claim":{"$ref":"#/components/schemas/Claim"},"source":{"$ref":"#/components/schemas/Source"}}},"meta":{"type":"object","description":"Version, dataset counts, snapshot time and evidence caveat."}},"required":["data","meta"]}}}},"400":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"404":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"405":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"503":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}}}}},"/fields":{"get":{"summary":"List capability fields","operationId":"List_capability_fields","parameters":[{"name":"company","in":"query","required":false,"description":"Optional company slug or UUID.","schema":{"type":"string","description":"Optional company slug or UUID.","minLength":0,"maxLength":200}}],"responses":{"200":{"description":"Public source-linked research records.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"claim_count":{"type":"integer"}}}},"meta":{"type":"object","description":"Version, dataset counts, snapshot time and evidence caveat."}},"required":["data","meta"]}}}},"400":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"404":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"405":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}},"503":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}}}}},"/meta":{"get":{"summary":"Get dataset status and counts","operationId":"Get_dataset_status","responses":{"200":{"description":"Current dataset metadata.","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Invalid arguments, missing records, or unavailable database.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"docs":{"type":"string","format":"uri"}}}}}}}}}},"components":{"schemas":{"Company":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"legal_name":{"type":["string","null"]},"headquarters_country":{"type":["string","null"]},"website_url":{"type":["string","null"]},"geography_notes":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"}},"required":["id","slug","name"]},"Claim":{"type":"object","properties":{"record_id":{"type":"string"},"company_id":{"type":"string","format":"uuid"},"company_slug":{"type":["string","null"]},"company_name":{"type":["string","null"]},"field":{"type":"string"},"normalized_value":{"type":"string"},"source_label_or_text":{"type":"string"},"source_url":{"type":"string","format":"uri"},"factory_or_entity":{"type":"string"},"production_tier":{"type":"string"},"material_or_product":{"type":"string"},"conditions_and_scope":{"type":"string"},"source_date_or_freshness":{"type":"string"},"evidence_status":{"type":"string"},"manual_check_status":{"type":"string"},"source_last_checked_at":{"type":["string","null"],"format":"date"},"translation_method":{"type":"string"},"source_published_or_revision_date":{"type":"string"},"record_created_at":{"type":"string","format":"date-time"},"record_updated_at":{"type":"string","format":"date-time"}},"required":["record_id","company_id","field","normalized_value","source_url","conditions_and_scope","evidence_status"]},"Source":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"company_id":{"type":"string","format":"uuid"},"language":{"type":"string"},"page_type":{"type":"string"},"review_status":{"type":"string"},"review_notes":{"type":"string"},"source_last_checked_at":{"type":["string","null"],"format":"date"},"record_created_at":{"type":"string","format":"date-time"},"record_updated_at":{"type":"string","format":"date-time"},"source_published_or_revision_date":{"type":"string"}},"required":["url","company_id","review_status"]},"Pagination":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}},"required":["total","limit","offset","has_more","next_offset"]}}}}