{"openapi":"3.1.0","info":{"title":"SeekAPI RFQ requirement intake","version":"2.0.0","description":"Public USD 19.90 RFQ Basic purchases are currently available. Up to 3 distinct suppliers, independent review, three China business days, at least one qualified quote or full service refund. Processed images are VISUAL_REFERENCE: TRANSFORM_APPLIED=true, ORIGINAL_BYTES_PRESERVED=false; no raw byte fidelity. References do not prove exact product match. Preparation does not charge, contact or fetch suppliers. Keep session cookies and save the confirm response privately before checkout. Recover the same order with checkout_return/result/renew; do not pay twice."},"servers":[{"url":"https://api.seekapi.ai"}],"paths":{"/checkout/stripe/rfq":{"post":{"operationId":"rfqIntake","summary":"Discover, prepare, confirm or recover the same RFQ requirement","parameters":[{"in":"header","name":"Origin","required":true,"schema":{"const":"https://api.seekapi.ai"}},{"in":"header","name":"x-seekapi-card-claim","required":true,"schema":{"const":"1"}},{"in":"header","name":"x-seekapi-rfq-live","required":false,"description":"Legacy private invitation only; ordinary public buyers need no invitation. Never publish or log invitation credentials.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","additionalProperties":false,"required":["action"],"properties":{"action":{"const":"discover"}}},{"type":"object","additionalProperties":false,"required":["action","draft"],"properties":{"action":{"const":"prepare_runtime"},"draft":{"$ref":"#/components/schemas/RFQ_AGENT_INTENT_V2"}}},{"type":"object","additionalProperties":false,"required":["action"],"properties":{"action":{"const":"session"}}},{"type":"object","additionalProperties":false,"required":["action","draft","receipt","requirement_digest","acknowledgement"],"properties":{"action":{"const":"confirm"},"draft":{"type":"object","description":"The unmodified prepared object excluding receipt"},"receipt":{"type":"string"},"requirement_digest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"acknowledgement":{"const":"CONFIRM_RFQ_REQUIREMENT"}}},{"type":"object","additionalProperties":false,"required":["action","access"],"properties":{"action":{"const":"checkout"},"access":{"type":"string"}}},{"type":"object","additionalProperties":false,"required":["action","reference"],"properties":{"action":{"const":"checkout_return"},"reference":{"type":"string"}}},{"type":"object","additionalProperties":false,"required":["action","access"],"properties":{"action":{"const":"result"},"access":{"type":"string"}}},{"type":"object","additionalProperties":false,"required":["action","access","handle"],"properties":{"action":{"const":"reference_asset"},"access":{"type":"string"},"handle":{"type":"string"}}},{"type":"object","additionalProperties":false,"required":["action","renewal","request_id"],"properties":{"action":{"const":"renew"},"renewal":{"type":"string"},"request_id":{"type":"string"}}}]}}}},"responses":{"200":{"description":"Current requirement, essential clarification, safe confirmation or private readback"},"400":{"description":"Invalid input, stale or altered digest; no external value effect"},"403":{"description":"Access denied"},"503":{"description":"New purchases paused, dependency health unknown or capacity full; keep the same order and retry after recovery, never pay twice"}}}}},"components":{"schemas":{"RFQ_AGENT_INTENT_V2":{"type":"object","properties":{"schema_version":{"type":"string","const":"RFQ_AGENT_INTENT_V2"},"product":{"type":"string","maxLength":200},"variant":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":4000,"default":""},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":32,"default":"pieces"},"destinationCountry":{"type":"string","maxLength":100},"destinationPort":{"type":"string","maxLength":100},"mustMatch":{"type":"array","items":{"type":"object","properties":{"attribute":{"type":"string","minLength":1,"maxLength":100},"expected":{"type":"string","minLength":1,"maxLength":200}},"required":["attribute","expected"],"additionalProperties":false},"maxItems":128,"default":[]},"matchPolicy":{"type":"string","enum":["EXACT_ONLY","SIMILAR_IF_MUST_MATCH"],"default":"EXACT_ONLY"},"source_references":{"title":"RFQ_SOURCE_REFERENCE_V1","description":"Source-neutral nonempty list for RFQ_AGENT_INTENT_V1.source_references; incoming evidence only. No default platform. Local validator supplies cross-reference/conflict/security checks. Not a deployed runtime API.","type":"array","minItems":1,"maxItems":64,"items":{"$ref":"#/components/schemas/RFQSource_reference"}},"buyer_policy":{"type":"object","properties":{"purpose":{"type":"string","enum":["OWN_USE","PRODUCTION_INPUT","WHOLESALE_RESALE","AMAZON_RESALE","OTHER"]},"minimum_savings_percent":{"type":"number","minimum":0,"maximum":100},"maximum_landed_unit_cost":{"type":"object","properties":{"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"],"additionalProperties":false},"budget":{"type":"object","properties":{"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"],"additionalProperties":false},"latest_acceptable_arrival":{"type":"string","format":"date-time"},"maximum_lead_days":{"type":"integer","minimum":0,"maximum":3650},"quality_risk_tolerance":{"type":"string","minLength":1,"maxLength":1000},"substitution_risk_tolerance":{"type":"string","minLength":1,"maxLength":1000},"sample_policy":{"type":"string","minLength":1,"maxLength":1000},"inspection_policy":{"type":"string","minLength":1,"maxLength":1000},"moq_tolerance":{"type":"string","minLength":1,"maxLength":1000},"delivery_basis":{"type":"string","minLength":1,"maxLength":1000},"hard_constraints":{"type":"array","items":{"type":"string","minLength":1,"maxLength":1000},"maxItems":40},"preferences":{"type":"array","items":{"type":"string","minLength":1,"maxLength":1000},"maxItems":40}},"additionalProperties":false,"default":{}},"asset_uploads":{"type":"array","items":{"type":"object","properties":{"handle":{"type":"string","pattern":"^asset:[a-zA-Z0-9_-]{1,128}$"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"media_type":{"type":"string","enum":["image/png","image/jpeg","image/webp","application/pdf","text/plain","text/csv"]},"data_base64":{"type":"string","maxLength":11184812}},"required":["handle","sha256","media_type","data_base64"],"additionalProperties":false},"maxItems":16,"default":[]},"default_retention_reference_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":64,"default":[]},"conflict_resolutions":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"reference_ids":{"type":"array","items":{"type":"string","maxLength":64},"minItems":1,"maxItems":64},"decision":{"type":"string","const":"USE_BUYER_SPEC"},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["field","reference_ids","decision","reason"],"additionalProperties":false},"maxItems":64,"default":[]}},"required":["schema_version","source_references"],"additionalProperties":false},"RFQSource_reference":{"type":"object","additionalProperties":false,"properties":{"reference_id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$"},"reference_type":{"enum":["STRUCTURED_REQUIREMENT","IMAGE","VIDEO_FRAME","TECHNICAL_DRAWING","CAD_OR_EXPORT","DATASHEET","SPEC_SHEET","CERTIFICATE","PART_NUMBER","MODEL","GTIN_UPC_EAN","BOM_LINE","ERP_ITEM","PRIOR_PO","INVOICE","EXISTING_QUOTE","PRODUCT_URL","PLATFORM_ITEM_ID","MANUFACTURER_CATALOGUE","INDUSTRIAL_CATALOGUE","SUPPLIER_URL","KEYWORD_QUERY","CATEGORY","MULTI_SOURCE_BUNDLE","GTIN","PRIOR_ORDER"]},"role":{"enum":["IDENTITY_REFERENCE","SPEC_REFERENCE","VISUAL_REFERENCE","PRICE_REFERENCE","COMPETITOR_REFERENCE","EXISTING_SUPPLIER_REFERENCE","DEMAND_SIGNAL","HISTORICAL_ORDER_REFERENCE"]},"platform_id":{"type":["string","null"],"maxLength":512},"domain":{"type":["string","null"],"maxLength":512},"identifier":{"type":["string","null"],"maxLength":512},"url":{"anyOf":[{"type":"string","maxLength":4096,"pattern":"^https://"},{"type":"null"}]},"asset":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"handle":{"type":"string","pattern":"^asset:[a-zA-Z0-9_-]{1,128}$"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"media_type":{"type":"string","minLength":1,"maxLength":128}},"required":["handle","sha256","media_type"]},{"type":"null"}]},"value":{"type":["string","null"],"maxLength":512},"member_reference_ids":{"type":"array","maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":64}},"provenance":{"enum":["BUYER_STATED","AGENT_INTERPRETED","SOURCE_OBSERVED","DERIVED","UNKNOWN"]},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"locale":{"type":["string","null"],"maxLength":512},"selected_variant":{"type":["string","null"],"maxLength":512},"facts":{"type":"array","maxItems":128,"items":{"$ref":"#/components/schemas/RFQSource_fact"}},"price":{"anyOf":[{"$ref":"#/components/schemas/RFQSource_price"},{"type":"null"}]},"rights":{"$ref":"#/components/schemas/RFQSource_rights"},"adapter_state":{"enum":["STRUCTURED_INPUT_ACCEPTED","LOCAL_ID_PARSE_ONLY","CURRENT_ADAPTER_PROVEN","REFERENCE_ONLY_IMAGE_OR_SPEC_REQUIRED","MANUAL_EVIDENCE_ONLY","UNSUPPORTED_OR_HIGH_RISK"]},"network_resolution_state":{"enum":["NOT_REQUESTED","LOCAL_PARSED","BLOCKED"]},"independently_verified_facts":{"type":"array","maxItems":0},"risk_flags":{"type":"array","uniqueItems":true,"maxItems":8,"items":{"enum":["PROHIBITED_GOODS","REGULATED_GOODS_POLICY_REVIEW","IP_ISSUE","UNSAFE_REFERENCE","PRIVATE_DATA","UNKNOWN"]}}},"required":["reference_id","reference_type","role","platform_id","domain","identifier","url","asset","value","member_reference_ids","provenance","observed_at","locale","selected_variant","facts","price","rights","adapter_state","network_resolution_state","independently_verified_facts","risk_flags"]},"RFQSource_fact":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string","minLength":1,"maxLength":128},"value":{"type":["string","number","boolean","null"],"maxLength":4096},"unit":{"type":["string","null"],"maxLength":512},"provenance":{"enum":["BUYER_STATED","AGENT_INTERPRETED","SOURCE_OBSERVED","DERIVED","UNKNOWN"]},"evidence_ref":{"type":["string","null"],"maxLength":512},"verification":{"const":"UNVERIFIED"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["field","value","unit","provenance","evidence_ref","verification","observed_at"]},"RFQSource_price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"unit":{"type":"string","minLength":1,"maxLength":64},"pack_count":{"type":"integer","minimum":1},"quantity_basis":{"type":"number","exclusiveMinimum":0},"selected_variant":{"type":"string","minLength":1,"maxLength":512},"region":{"type":"string","minLength":1,"maxLength":512},"seller":{"type":"string","minLength":1,"maxLength":512},"observed_at":{"type":"string","format":"date-time"},"locale":{"type":"string","minLength":1,"maxLength":64},"tax_scope":{"type":"string","minLength":1,"maxLength":512},"shipping_scope":{"type":"string","minLength":1,"maxLength":512},"promotion_scope":{"type":"string","minLength":1,"maxLength":512},"incoterm":{"type":"string","minLength":1,"maxLength":64},"named_place":{"type":"string","minLength":1,"maxLength":512},"observation_type":{"enum":["BUYER_REFERENCE_PRICE","LISTING_OBSERVED","SUPPLIER_QUOTE_CLAIM","PRIOR_PAID_COST_CLAIM","ESTIMATED"]},"provenance":{"enum":["BUYER_STATED","AGENT_INTERPRETED","SOURCE_OBSERVED","DERIVED"]},"verification":{"const":"UNVERIFIED"},"evidence_ref":{"type":"string","minLength":1,"maxLength":512},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["amount","currency","unit","pack_count","quantity_basis","selected_variant","region","seller","observed_at","locale","tax_scope","shipping_scope","promotion_scope","incoterm","named_place","observation_type","provenance","verification","evidence_ref","valid_until"]},"RFQSource_rights":{"type":"object","additionalProperties":false,"properties":{"state":{"enum":["PRIVATE_ONLY","CUSTOMER_SHAREABLE","SUPPLIER_CONSENTED","LICENSED_PUBLIC","AGGREGATED_PUBLIC_SAFE","UNKNOWN"]},"access_class":{"enum":["CUSTOMER_PRIVATE","SEEKAPI_INTERNAL_INTELLIGENCE"]},"content_rights":{"enum":["BUYER_OWNED","AUTHORIZED_REFERENCE","UNKNOWN"]},"image_rights":{"enum":["BUYER_OWNED","AUTHORIZED_REFERENCE","NOT_APPLICABLE","UNKNOWN"]},"evidence_ref":{"type":["string","null"],"maxLength":512},"retention":{"type":"object","additionalProperties":false,"properties":{"purpose":{"const":"RFQ_REFERENCE"},"delete_after":{"type":"string","format":"date-time"},"reuse_allowed":{"const":false}},"required":["purpose","delete_after","reuse_allowed"]}},"required":["state","access_class","content_rights","image_rights","evidence_ref","retention"]}}}}