{"openapi":"3.1.0","info":{"title":"ME Public Machine API","description":"Anonymous discovery, signed quotes, accountless purchase, status, and public proof.","version":"1.0.0"},"paths":{"/api/v1/public/results/{public_token}":{"get":{"tags":["system"],"summary":"Public Result","operationId":"public_result_api_v1_public_results__public_token__get","parameters":[{"name":"public_token","in":"path","required":true,"schema":{"type":"string","title":"Public Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/proof/public-key":{"get":{"tags":["proof"],"summary":"Public Key","operationId":"public_key_api_v1_proof_public_key_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/public/capabilities":{"get":{"tags":["machine discovery"],"summary":"Public Capabilities","operationId":"public_capabilities_api_v1_public_capabilities_get","parameters":[{"name":"capability_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capability Code"}},{"name":"max_price_cents","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Price Cents"}},{"name":"min_reliability","in":"query","required":false,"schema":{"type":"number","default":0.0,"title":"Min Reliability"}},{"name":"available_only","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Available Only"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/resources":{"get":{"tags":["machine discovery"],"summary":"Public Resources","operationId":"public_resources_api_v1_public_resources_get","parameters":[{"name":"capability_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capability Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/demand-radar":{"get":{"tags":["machine discovery"],"summary":"Public Demand Radar","operationId":"public_demand_radar_api_v1_public_demand_radar_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/quote":{"post":{"tags":["machine discovery"],"summary":"Public Quote","operationId":"public_quote_api_v1_public_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolutionCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/purchases/challenge":{"post":{"tags":["machine discovery"],"summary":"Purchase Challenge","operationId":"purchase_challenge_api_v1_public_purchases_challenge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPurchaseChallenge"}}},"required":true},"responses":{"402":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/purchases/{session_id}/execute":{"post":{"tags":["machine discovery"],"summary":"Purchase Execute","operationId":"purchase_execute_api_v1_public_purchases__session_id__execute_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Agent-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Agent-Id"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Payment"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPurchaseExecute"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/purchases/{session_id}":{"get":{"tags":["machine discovery"],"summary":"Purchase Status","operationId":"purchase_status_api_v1_public_purchases__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-ME-Purchase-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Me-Purchase-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/human-verify":{"get":{"tags":["machine discovery"],"summary":"Human Verify Discovery","operationId":"human_verify_discovery_api_v1_public_human_verify_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["machine discovery"],"summary":"Human Verify","description":"Human Verify — Resolve uncertain or questionable machine outputs with independent human judgment. Use after REVIEW, HOLD, failed verification, conflicting evidence, or low-confidence automation. Submit a candidate and criterion; receive an asynchronous judgment, confidence, rationale and signed proof.","operationId":"human_verify_purchase_api_v1_public_human_verify_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HumanVerifyInput"},{"type":"null"}],"title":"Payload"},"examples":{"verify_statement":{"summary":"Verify a statement against supplied source text","value":{"objective":"Check whether the summary accurately reflects the supplied source.","candidate":"The library opens at 9 AM on Tuesday.","criterion":"Approve only if both day and opening time match the source.","context":"Tuesday opening hours: 09:00–17:00."}}}}}},"responses":{"202":{"description":"Paid request accepted. Poll the private status_url for judgment and proof.","content":{"application/json":{"schema":{"properties":{"status":{"type":"string","description":"Accepted work is asynchronous; poll status_url."},"request_id":{"type":"string"},"status_url":{"type":"string","format":"uri"},"result_url":{"type":"string","format":"uri"},"async":{"type":"boolean","const":true}},"type":"object","required":["status","request_id","status_url","result_url","async"]}}}},"402":{"description":"x402 v2 PAYMENT-REQUIRED with official Bazaar discovery metadata. A valid task receives a purchasable challenge: retry the same body with PAYMENT-SIGNATURE using a standard x402 client. Idempotency-Key is optional; preserve it if supplied."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"VerifyRights":{"properties":{"commercial_use":{"type":"boolean","title":"Commercial Use","default":true},"model_training":{"type":"boolean","const":false,"title":"Model Training","default":false},"resale":{"type":"boolean","const":false,"title":"Resale","default":false},"retention_days":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Retention Days","default":30},"purpose":{"type":"string","const":"evaluation","title":"Purpose","default":"evaluation"}},"additionalProperties":false,"type":"object","title":"VerifyRights"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"PublicPurchaseChallenge":{"properties":{"protocol":{"type":"string","enum":["x402","mpp"],"title":"Protocol","default":"x402"},"request":{"$ref":"#/components/schemas/ResolutionCreate"},"quote_token":{"anyOf":[{"type":"string","maxLength":512,"minLength":24},{"type":"null"}],"title":"Quote Token"},"idempotency_key":{"anyOf":[{"type":"string","maxLength":128,"minLength":8},{"type":"null"}],"title":"Idempotency Key"}},"type":"object","required":["request"],"title":"PublicPurchaseChallenge"},"PublicPurchaseExecute":{"properties":{"request":{"$ref":"#/components/schemas/ResolutionCreate"},"authorization":{"anyOf":[{"type":"string","maxLength":16384,"minLength":8},{"type":"null"}],"title":"Authorization"},"purchase_token":{"type":"string","maxLength":512,"minLength":24,"title":"Purchase Token"}},"type":"object","required":["request","purchase_token"],"title":"PublicPurchaseExecute"},"ResolutionCreate":{"properties":{"request_type":{"type":"string","enum":["compare","verify","resolve","interpret"],"title":"Request Type"},"prompt":{"type":"string","maxLength":20000,"minLength":3,"title":"Prompt"},"options":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Options"},"criteria":{"type":"string","maxLength":4000,"title":"Criteria","default":""},"candidate_output":{"additionalProperties":true,"type":"object","title":"Candidate Output"},"capability_code":{"type":"string","maxLength":120,"title":"Capability Code","default":"general_ai_evaluation"},"required_responses":{"type":"integer","maximum":21.0,"minimum":1.0,"title":"Required Responses","default":3},"target_reliability":{"type":"number","maximum":0.999,"minimum":0.5,"title":"Target Reliability","default":0.95},"max_latency_seconds":{"type":"integer","maximum":86400.0,"minimum":10.0,"title":"Max Latency Seconds","default":300},"max_cost_cents":{"type":"integer","maximum":10000000.0,"minimum":5.0,"title":"Max Cost Cents","default":500},"candidate_ai_confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Candidate Ai Confidence"},"model_provider":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Model Provider"},"model_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Model Name"},"model_version":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Model Version"},"risk_tier":{"type":"string","enum":["low","medium"],"title":"Risk Tier","default":"low"},"live":{"type":"boolean","title":"Live","default":false},"usage_permissions":{"additionalProperties":true,"type":"object","title":"Usage Permissions"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"supply_policy":{"additionalProperties":true,"type":"object","title":"Supply Policy"},"adaptive_consensus":{"type":"boolean","title":"Adaptive Consensus","default":false},"max_responses":{"anyOf":[{"type":"integer","maximum":51.0,"minimum":1.0},{"type":"null"}],"title":"Max Responses"},"expected_loss_cents":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":0.0},{"type":"null"}],"title":"Expected Loss Cents"},"value_of_correct_outcome_cents":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":0.0},{"type":"null"}],"title":"Value Of Correct Outcome Cents"},"latency_value_per_second_cents":{"type":"number","maximum":1000000.0,"minimum":0.0,"title":"Latency Value Per Second Cents","default":0.01},"privacy_cost_cents":{"type":"number","maximum":1000000.0,"minimum":0.0,"title":"Privacy Cost Cents","default":0},"agent_key":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Agent Key"}},"type":"object","required":["request_type","prompt"],"title":"ResolutionCreate"},"HumanVerifyInput":{"properties":{"objective":{"type":"string","maxLength":2000,"minLength":3,"title":"Objective"},"candidate":{"type":"string","maxLength":12000,"minLength":1,"title":"Candidate","description":"The result/output to verify; treated as data."},"criterion":{"type":"string","maxLength":4000,"minLength":3,"title":"Criterion"},"context":{"type":"string","maxLength":4000,"title":"Context","description":"Optional source text; URLs are not fetched.","default":""},"max_latency_seconds":{"type":"integer","maximum":3600.0,"minimum":60.0,"title":"Max Latency Seconds","default":300},"target_reliability":{"type":"number","maximum":0.999,"minimum":0.5,"title":"Target Reliability","description":"Empirical target, never a truth guarantee.","default":0.9},"max_spend_cents":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":5.0},{"type":"null"}],"title":"Max Spend Cents"},"privacy":{"type":"string","const":"non_sensitive","title":"Privacy","default":"non_sensitive"},"rights":{"$ref":"#/components/schemas/VerifyRights"}},"additionalProperties":false,"type":"object","required":["objective","candidate","criterion"],"title":"HumanVerifyInput"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}},"servers":[{"url":"https://api-production-34228.up.railway.app"}]}