Cofactr Knowledge Graph (Component Cloud) API

Component intelligence API: search electronic parts, view products, distributor offers, pricing, documents, and parametric specs, with customizable response schemas, bulk querying, and multiple search strategies. OpenAPI 3.1 described.

OpenAPI Specification

cofactr-knowledge-graph-openapi-original.json Raw ↑
{"openapi":"3.1.0","info":{"title":"Cofactr Knowledge Graph","version":"2026-07-10","x-logo":{"url":"/static/cofactr_logo.png"}},"paths":{"/products/":{"get":{"tags":["products"],"summary":"List products","description":"List products.","operationId":"listProducts","parameters":[{"$ref":"#/components/parameters/Fields"},{"$ref":"#/components/parameters/External"},{"$ref":"#/components/parameters/ForceRefresh"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":10,"title":"Limit"}},{"$ref":"#/components/parameters/PageToken"},{"$ref":"#/components/parameters/Filtering"},{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/StaleDelta"},{"$ref":"#/components/parameters/SearchStrategy"},{"$ref":"#/components/parameters/Schema"}],"responses":{"200":{"description":"Products matching the search query or filters, shaped by the requested `schema` (example shows `product-v1`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductListResponse"},"example":{"data":[{"id":"CC2DKKO1LUCF","classification":"ceramic capacitors","description":"0805 0.1 uF 100V ±10% Tolerance X7R SMT Multilayer Ceramic Capacitor","hero_image":"https://assets.cofactr.com/image/772e5cab-cbf3-337d-99ff-c8ac79448a0c.jpg","mfr":"Murata","mpn":"GCM21BR72A104KA37L","alt_mpns":["GCM21BR72A104KA37L.","GCM21BR72A104KA37L"],"msl":"1","package":"0805","termination_type":"SMT","lifecycle_status":"Production","inventory_level":31089253,"buyable":31,"quotable":35,"maybe":0,"updated_at":"2026-07-09T22:21:55.650630+00:00","deprecated_ids":["XXLL0JPD4W2X","CC96NA4H7MOT","CCI0BFAAL00D"]}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. This may be the monthly product quota or the concurrent-request ceiling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds until the request may be retried. Always present on 429/504.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"string"}},"X-RateLimit-ResetTime":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"string"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Request exceeded the maximum processing time (concurrency-limited clients).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds until the request may be retried. Always present on 429/504.","schema":{"type":"string"}}}}}}},"/products/{id}":{"get":{"tags":["products"],"summary":"View product","description":"View product.","operationId":"getProduct","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"$ref":"#/components/parameters/StaleDelta"},{"$ref":"#/components/parameters/Fields"},{"$ref":"#/components/parameters/External"},{"$ref":"#/components/parameters/ForceRefresh"},{"$ref":"#/components/parameters/Schema"}],"responses":{"200":{"description":"The requested product, shaped by the requested `schema` (example shows `product-offers-v1`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductViewResponse"},"example":{"data":{"id":"CC2DKKO1LUCF","classification":"ceramic capacitors","description":"0805 0.1 uF 100V ±10% Tolerance X7R SMT Multilayer Ceramic Capacitor","documents":[{"label":"Datasheet","url":"https://www.mouser.com/datasheet/2/281/1/GCM21BR72A104KA37_01A-3145807.pdf","filename":"Untitled"},{"label":"Reach Statement","url":"http://sigma.octopart.com/reach_statement/Murata-company-16.pdf","filename":"Murata-company-16.pdf"}],"hero_image":"https://assets.cofactr.com/image/772e5cab-cbf3-337d-99ff-c8ac79448a0c.jpg","mfr":"Murata","mpn":"GCM21BR72A104KA37L","alt_mpns":["GCM21BR72A104KA37L.","GCM21BR72A104KA37L"],"msl":"1","package":"0805","specs":[{"id":"capacitance","label":"Capacitance","display_value":"100 nF","quantity":{"unit":"F","amount":1e-07}},{"id":"voltagerating_dc_","label":"Voltage rating (DC)","display_value":"100 V","quantity":{"unit":"V","amount":100}},{"id":"temperaturecoefficient","label":"Temperature coefficient","display_value":"X7R"}],"product_updated_at":"2026-07-09T22:21:55.650630+00:00","termination_type":"SMT","deprecated_ids":["XXLL0JPD4W2X","CC96NA4H7MOT","CCI0BFAAL00D"],"min_lead":3,"offers":[{"part":"CC2DKKO1LUCF","seller":{"id":"622fb450e4c292d8287b0af5","deprecated_ids":["62d4bcc6412443e55717f293","62d4bcc6412443e55717f291","62d4bcc6412443e55717f28f"],"label":"Digi-Key","aliases":["Digi-Key Kit","Digi-Key Corporation","DIGI-KEY EVALUATION BOARDS","Digikey","Digi-Key Electronics"],"certifications":["AS9120","CFR21"],"lead":3,"free_ship":{"threshold":250,"shipping_lead":2},"shipping_options":[{"price":29.99,"shipping_lead":1},{"price":13.99,"shipping_lead":2},{"price":0,"shipping_lead":5}],"convenience_return_window":30,"scheduled_release_period":12,"us_shipping_methods":{"UPS 1 day":1,"UPS 2 day":2,"UPS 3 day":3,"UPS ground":5},"international_shipping_methods":{"DHL worldwide Express":3,"UPS worldwide saver":4},"custom_reel_price":0.0},"is_authorized":true,"shipping_lead":4,"ships_from_country":"US","sku":"490-4789-2-ND","inventory_level":652178,"packaging":"Tape & Reel","moq":3000,"prices":[{"quantity":3000,"price":0.03828,"currency":"USD","converted_currency":"USD","converted_price":0.03828,"conversion_rate":1.0},{"quantity":6000,"price":0.0354,"currency":"USD","converted_currency":"USD","converted_price":0.0354,"conversion_rate":1.0},{"quantity":9000,"price":0.03395,"currency":"USD","converted_currency":"USD","converted_price":0.03395,"conversion_rate":1.0}],"factory_lead_days":147,"order_multiple":1,"offer_updated_at":"2026-07-11T00:54:11.127659+00:00"}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. This may be the monthly product quota or the concurrent-request ceiling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds until the request may be retried. Always present on 429/504.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"string"}},"X-RateLimit-ResetTime":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"string"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Request exceeded the maximum processing time (concurrency-limited clients).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds until the request may be retried. Always present on 429/504.","schema":{"type":"string"}}}}}}},"/products/autocompletions/":{"get":{"tags":["products"],"summary":"List product autocompletions","description":"List product autocompletions.","operationId":"autocompleteProducts","parameters":[{"$ref":"#/components/parameters/Q"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":500,"exclusiveMinimum":0},{"type":"null"}],"description":"Maximum number of predictions that may be returned.","default":10,"title":"Limit"},"description":"Maximum number of predictions that may be returned."}],"responses":{"200":{"description":"Autocomplete predictions for the query, best match first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutocompletionsResponse"},"example":{"data":[{"id":"CC2DKKO1LUCF","label":"Murata Electronics GCM21BR72A104KA37L"},{"id":"CCEHW3JXS5CQ","label":"Murata Electronics GCM21BR71H104KA37L"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. This may be the monthly product quota or the concurrent-request ceiling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds until the request may be retried. Always present on 429/504.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"string"}},"X-RateLimit-ResetTime":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"string"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Request exceeded the maximum processing time (concurrency-limited clients).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds until the request may be retried. Always present on 429/504.","schema":{"type":"string"}}}}}}},"/batch/products/":{"post":{"tags":["batch"],"summary":"Execute a batch of product queries","description":"Execute a batch of product queries.","operationId":"batchProducts","parameters":[{"$ref":"#/components/parameters/Timeout"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductsBatch"}}}},"responses":{"200":{"description":"One response per batch member, in request order. Each member carries the status code and body it would have received as a standalone request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBatchResponse"},"example":[{"code":200,"body":{"data":[{"id":"CC2DKKO1LUCF","classification":"ceramic capacitors","description":"0805 0.1 uF 100V ±10% Tolerance X7R SMT Multilayer Ceramic Capacitor","documents":[{"label":"Datasheet","url":"https://www.mouser.com/datasheet/2/281/1/GCM21BR72A104KA37_01A-3145807.pdf","filename":"Untitled"},{"label":"Reach Statement","url":"http://sigma.octopart.com/reach_statement/Murata-company-16.pdf","filename":"Murata-company-16.pdf"}],"hero_image":"https://assets.cofactr.com/image/772e5cab-cbf3-337d-99ff-c8ac79448a0c.jpg","mfr":"Murata","mpn":"GCM21BR72A104KA37L","alt_mpns":["GCM21BR72A104KA37L.","GCM21BR72A104KA37L"],"msl":"1","package":"0805","specs":[{"id":"capacitance","label":"Capacitance","display_value":"100 nF","quantity":{"unit":"F","amount":1e-07}},{"id":"voltagerating_dc_","label":"Voltage rating (DC)","display_value":"100 V","quantity":{"unit":"V","amount":100}},{"id":"temperaturecoefficient","label":"Temperature coefficient","display_value":"X7R"}],"product_updated_at":"2026-07-09T22:21:55.650630+00:00","termination_type":"SMT","deprecated_ids":["XXLL0JPD4W2X","CC96NA4H7MOT","CCI0BFAAL00D"],"min_lead":3,"offers":[{"part":"CC2DKKO1LUCF","seller":{"id":"622fb450e4c292d8287b0af5","deprecated_ids":["62d4bcc6412443e55717f293","62d4bcc6412443e55717f291","62d4bcc6412443e55717f28f"],"label":"Digi-Key","aliases":["Digi-Key Kit","Digi-Key Corporation","DIGI-KEY EVALUATION BOARDS","Digikey","Digi-Key Electronics"],"certifications":["AS9120","CFR21"],"lead":3,"free_ship":{"threshold":250,"shipping_lead":2},"shipping_options":[{"price":29.99,"shipping_lead":1},{"price":13.99,"shipping_lead":2},{"price":0,"shipping_lead":5}],"convenience_return_window":30,"scheduled_release_period":12,"us_shipping_methods":{"UPS 1 day":1,"UPS 2 day":2,"UPS 3 day":3,"UPS ground":5},"international_shipping_methods":{"DHL worldwide Express":3,"UPS worldwide saver":4},"custom_reel_price":0.0},"is_authorized":true,"shipping_lead":4,"ships_from_country":"US","sku":"490-4789-2-ND","inventory_level":652178,"packaging":"Tape & Reel","moq":3000,"prices":[{"quantity":3000,"price":0.03828,"currency":"USD","converted_currency":"USD","converted_price":0.03828,"conversion_rate":1.0},{"quantity":6000,"price":0.0354,"currency":"USD","converted_currency":"USD","converted_price":0.0354,"conversion_rate":1.0},{"quantity":9000,"price":0.03395,"currency":"USD","converted_currency":"USD","converted_price":0.03395,"conversion_rate":1.0}],"factory_lead_days":147,"order_multiple":1,"offer_updated_at":"2026-07-11T00:54:11.127659+00:00"}]}]}},{"code":200,"body":{"data":[{"id":"CC2DKKO1LUCF","classification":"ceramic capacitors","description":"0805 0.1 uF 100V ±10% Tolerance X7R SMT Multilayer Ceramic Capacitor","hero_image":"https://assets.cofactr.com/image/772e5cab-cbf3-337d-99ff-c8ac79448a0c.jpg","mfr":"Murata","mpn":"GCM21BR72A104KA37L","alt_mpns":["GCM21BR72A104KA37L.","GCM21BR72A104KA37L"],"msl":"1","package":"0805","termination_type":"SMT","lifecycle_status":"Production","inventory_level":31089253,"buyable":31,"quotable":35,"maybe":0,"updated_at":"2026-07-09T22:21:55.650630+00:00","deprecated_ids":["XXLL0JPD4W2X","CC96NA4H7MOT","CCI0BFAAL00D"]}]}}]}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. This may be the monthly product quota or the concurrent-request ceiling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds until the request may be retried. Always present on 429/504.","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"string"}},"X-RateLimit-ResetTime":{"description":"Present only when the monthly product quota was exceeded.","schema":{"type":"string"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Request exceeded the maximum processing time (concurrency-limited clients).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds until the request may be retried. Always present on 429/504.","schema":{"type":"string"}}}}}}}},"components":{"schemas":{"APIOperation":{"properties":{"method":{"type":"string","const":"GET","title":"Method"},"relative_url":{"type":"string","title":"Relative Url"}},"type":"object","required":["method","relative_url"],"title":"APIOperation","description":"API Operation for GET requests."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ProductsBatch":{"properties":{"batch":{"items":{"$ref":"#/components/schemas/APIOperation"},"type":"array","maxItems":250,"title":"Batch"}},"type":"object","required":["batch"],"title":"ProductsBatch","description":"Batch of product requests.","examples":[{"batch":[{"method":"GET","relative_url":"?q=GCM21BR72A104KA37L&schema=product-offers-v1&external=true&search_strategy=mpn_sku_mfr"},{"method":"GET","relative_url":"?filtering=[{\"field\":\"id\",\"operator\":\"IN\",\"value\":[\"CC2DKKO1LUCF\"]}]&schema=product-v1"}]}]},"SearchStrategy":{"type":"string","enum":["default","mpn_exact_mfr","mpn_exact","mpn_exact_multi","mpn_sku_mfr"],"title":"SearchStrategy","description":"Search strategy."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ProductV0":{"title":"ProductV0","description":"Basic product information model for external API responses.","type":"object","properties":{"id":{"type":"string"},"classification":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"hero_image":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mfr":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mpn":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"alt_mpns":{"type":"array","items":{"type":"string"},"default":[]},"msl":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"package":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"terminations":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"termination_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"lifecycle_status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"inventory_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"buyable":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"quotable":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"maybe":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null}},"required":["id"]},"ProductV1":{"title":"ProductV1","description":"Basic product information model for external API responses.","type":"object","properties":{"id":{"type":"string"},"classification":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"hero_image":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mfr":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mpn":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"alt_mpns":{"type":"array","items":{"type":"string"},"default":[]},"msl":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"package":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"terminations":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"termination_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"lifecycle_status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"inventory_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"buyable":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"quotable":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"maybe":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"deprecated_ids":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id"]},"ProductOffersV0":{"title":"ProductOffersV0","type":"object","properties":{"id":{"type":"string"},"classification":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"documents":{"type":"array","items":{"$ref":"#/components/schemas/ProductDocument"},"default":[]},"hero_image":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mfr":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mpn":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"alt_mpns":{"type":"array","items":{"type":"string"},"default":[]},"msl":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"package":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"specs":{"type":"array","items":{"$ref":"#/components/schemas/ProductSpec"},"default":[]},"terminations":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"inventory_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"buyable":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"quotable":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"maybe":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"termination_type":{"type":"string","default":"other"},"buyable_reference_prices":{"type":"array","items":{"$ref":"#/components/schemas/PricePoint"},"default":[]},"reference_prices":{"type":"array","items":{"$ref":"#/components/schemas/PricePoint"},"default":[]},"deprecated_ids":{"type":"array","items":{"type":"string"},"default":[]},"min_lead":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"offers":{"type":"array","items":{"$ref":"#/components/schemas/OffersV0"},"default":[]}},"required":["id"]},"ProductDocument":{"title":"ProductDocument","description":"Class name is part of the public OpenAPI contract. Do not rename casually.","type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"},"filename":{"type":"string"}},"required":["label","url","filename"]},"ProductSpec":{"title":"ProductSpec","description":"Class name is part of the public OpenAPI contract. Do not rename casually.","type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"value":{"type":"string"}},"required":["id","label","value"]},"PricePoint":{"title":"PricePoint","description":"Price in a specific currency + quantity.\n    Based on https://octopart.com/api/v4/reference#pricepoint\n\n    Class name is part of the public OpenAPI contract. Do not rename casually.","type":"object","properties":{"quantity":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"converted_currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"converted_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"conversion_rate":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["quantity","price","currency","converted_currency","converted_price","conversion_rate"]},"OffersV0":{"title":"OffersV0","description":"Offers v0 schema.","type":"object","properties":{"part":{"type":"string"},"seller":{"$ref":"#/components/schemas/Seller"},"is_authorized":{"type":"boolean","default":false},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"shipping_lead":{"type":"integer"},"ships_from_country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"inventory_level":{"type":"integer","default":0},"packaging":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"moq":{"type":"integer","default":1},"prices":{"type":"array","items":{"$ref":"#/components/schemas/PricePoint"},"default":[]},"updated_at":{"type":"string"},"factory_lead_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"on_order_quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"factory_pack_quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"order_multiple":{"type":"integer","default":1},"multipack_quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"is_foreign":{"type":"boolean","default":false}},"required":["part","seller","shipping_lead","updated_at"]},"Seller":{"title":"Seller","description":"Class name is part of the public OpenAPI contract. Do not rename casually.","type":"object","properties":{"id":{"type":"string"},"deprecated_ids":{"type":"array","items":{"type":"string"},"default":[]},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"aliases":{"type":"array","items":{"type":"string"},"default":[]},"additional_fee":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null},"additional_markup":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null},"authenticity_score":{"type":"number"},"availability_score":{"type":"number"},"certifications":{"type":"array","items":{"type":"string"},"default":[]},"is_buyable":{"type":"boolean"},"lead":{"type":"integer"},"free_ship":{"$ref":"#/components/schemas/FreeShipTerms"},"shipping_options":{"type":"array","items":{"type":"object"}},"best_case_lead":{"anyOf":[{"type":"integer"},{"type":"null"}]},"overlap":{"type":"boolean"},"convenience_return_window":{"anyOf":[{"type":"integer"},{"type":"null"}]},"scheduled_release_period":{"anyOf":[{"type":"integer"},{"type":"null"}]},"is_api_ordering_supported":{"type":"boolean"},"is_api_order_status_supported":{"type":"boolean"},"us_shipping_methods":{"type":"object","additionalProperties":{"type":"integer"}},"international_shipping_methods":{"type":"object","additionalProperties":{"type":"integer"}},"custom_reel_price":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","authenticity_score","availability_score","is_buyable","lead","shipping_options","best_case_lead","overlap","convenience_return_window","scheduled_release_period","is_api_ordering_supported","is_api_order_status_supported","us_shipping_methods","international_shipping_methods","custom_reel_price"]},"FreeShipTerms":{"title":"FreeShipTerms","description":"Class name is part of the public OpenAPI contract. Do not rename casually.","type":"object","properties":{"threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null},"shipping_lead":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null}},"required":[]},"ProductOffersV1":{"title":"ProductOffersV1","description":"Product details with offers for new public API integrations.","type":"object","properties":{"id":{"type":"string"},"classification":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"documents":{"type":"array","items":{"$ref":"#/components/schemas/ProductDocument"},"default":[]},"hero_image":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mfr":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"mpn":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"alt_mpns":{"type":"array","items":{"type":"string"},"default":[]},"msl":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"package":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"specs":{"type":"array","items":{"$ref":"#/components/schemas/ProductOffersV1Spec"},"default":[]},"terminations":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"product_updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"termination_type":{"type":"string","default":"other"},"deprecated_ids":{"type":"array","items":{"type":"string"},"default":[]},"min_lead":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"offers":{"type":"array","items":{"$ref":"#/components/schemas/ProductOffersV1Offer"},"default":[]}},"required":["id"]},"ProductOffersV1Spec":{"title":"ProductOffersV1Spec","description":"Product specification for product-offers-v1.","type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"display_value":{"type":"string"},"quantity":{"anyOf":[{"type":"null"},{"$ref":"#/components/schemas/ProductOffersV1Quantity"}],"default":null}},"required":["id","label","display_value"]},"ProductOffersV1Quantity":{"title":"ProductOffersV1Quantity","description":"Structured quantity for product-offers-v1 specs.","type":"object","properties":{"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null},"lower_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null},"upper_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null}},"required":[]},"ProductOffersV1Offer":{"title":"ProductOffersV1Offer","description":"Supplier offer for product-offers-v1.","type":"object","properties":{"part":{"type":"string"},"seller":{"$ref":"#/components/schemas/ProductOffersV1Seller"},"is_authorized":{"type":"boolean","default":false},"shipping_lead":{"type":"integer"},"ships_from_country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"inventory_level":{"type":"integer","default":0},"packaging":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"moq":{"type":"integer","default":1},"prices":{"type":"array","items":{"$ref":"#/components/schemas/PricePoint"},"default":[]},"offer_updated_at":{"type":"string"},"factory_lead_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"factory_pack_quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"order_multiple":{"type":"integer","default":1}},"required":["part","seller","shipping_lead","offer_updated_at"]},"ProductOffersV1Seller":{"title":"ProductOffersV1Seller","description":"Seller fields exposed by product-offers-v1.","type":"object","properties":{"id":{"type":"string"},"deprecated_ids":{"type":"array","items":{"type":"string"},"default":[]},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"aliases":{"type":"array","items":{"type":"string"},"default":[]},"certifications":{"type":"array","items":{"type":"string"},"default":[]},"lead":{"type":"integer"},"free_ship":{"$ref":"#/components/schemas/FreeShipTerms"},"shipping_options":{"type":"array","items":{"type":"object"}},"best_case_lead":{"anyOf":[{"type":"integer"},{"type":"null"}]},"convenience_return_window":{"anyOf":[{"type":"integer"},{"type":"null"}]},"scheduled_release_period":{"anyOf":[{"type":"integer"},{"type":"null"}]},"us_shipping_methods":{"type":"object","additionalProperties":{"type":"integer"}},"international_shipping_methods":{"type":"object","additionalProperties":{"type":"integer"}},"custom_reel_price":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","lead","shipping_options","best_case_lead","convenience_return_window","scheduled_release_period","us_shipping_methods","international_shipping_methods","custom_reel_price"]},"Error":{"type":"object","required":["detail"],"properties":{"detail":{"type":"string","description":"Human-readable explanation of the error."}}},"Autocompletion":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Cofactr product ID (CPID)."},"label":{"type":"string","description":"Display label: manufacturer + MPN."}}},"BatchMemberResult":{"type":"object","required":["code","body"],"properties":{"code":{"type":"integer","description":"HTTP status code the member request would have received as a standalone request."},"body":{"description":"The JSON body the member request would have received as a standalone request: a product list envelope (`ProductListResponse`) on success, or a validation/error body on failure."}}},"ProductListResponse":{"type":"object","description":"The shape of `data` is selected by the required `schema` query parameter: `product-v0` → ProductV0, `product-v1` → ProductV1, `product-offers-v0` → ProductOffersV0, `product-offers-v1` → ProductOffersV1.","required":["data"],"properties":{"data":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ProductV0"},{"$ref":"#/components/schemas/ProductV1"},{"$ref":"#/components/schemas/ProductOffersV0"},{"$ref":"#/components/schemas/ProductOffersV1"}]}}}},"ProductViewResponse":{"type":"object","description":"The shape of `data` is se

# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cofactr/refs/heads/main/openapi/cofactr-knowledge-graph-openapi-original.json