{"openapi":"3.1.0","info":{"title":"ApexScout AgentCore Gateway Import","version":"v2.2.81-brand-asset-integration","summary":"OpenAPI import surface for AgentCore-style x402 buyer agents.","description":"ApexScout is an inbound-only x402 trust and monetization intelligence API. Paid routes return HTTP 402 JSON before payment and one JSON response after buyer-controlled x402 payment. This is seller-side import metadata for AgentCore Payments-style buyers, not an AWS, Coinbase, or Stripe endorsement claim."},"servers":[{"url":"https://apexscout.ai"}],"tags":[{"name":"free-readiness","description":"Free owned surfaces that help a buyer inspect ApexScout before payment."},{"name":"paid-x402","description":"x402 protected paid routes. Unpaid calls should return HTTP 402 JSON."}],"x-apexscout":{"release":"v2.2.81-brand-asset-integration","liveMode":"zero-contact-inbound-only","productionRail":"Base mainnet x402","network":"eip155:8453","firstPaidRoute":"/api/opportunity-check","builderMonetizationRoute":"/api/agent-revenue-audit","buyerAgentSpendPolicy":"/api/agentcore-payments-policy","buyerAgentSpendPolicyWellKnown":"/.well-known/apexscout-spend-policy.json","buyerAgentStart":"/api/agentcore-buyer-start","buyerAgentSpendPassport":"/api/agent-spend-passport","buyerAgentSpendPassportPrepare":"/api/agent-spend-passport/prepare","x402MetadataPreflight":"/api/x402-metadata-preflight","x402MetadataPreflightCheck":"/api/x402-metadata-preflight/check","recommendedNoSpendPreflight":"/api/agent-spend-passport/prepare","passportFirstCta":"Not sure what to buy? Generate a free Agent Spend Passport before paying.","passportExplanation":"The Passport does not spend money. It recommends the right route, checks budget fit, warns about sensitive fields, and gives a safe copy-paste paid-call payload.","passportFirstBuyerPath":["Inspect /x402-proof.","Generate a free /agent-spend-passport.","If the Passport recommends the $5 audit, preview /agent-revenue-audit-preview before paying.","Run the free /x402-metadata-preflight before any paid retry if the buyer metadata includes a resource URL, payment description, reason string, or payload preview.","If Passport recommends /api/opportunity-check, use the $0.01 route.","If Passport recommends /api/agent-revenue-audit, use the $5 route only with approved budget.","Stop if Passport says stop."],"recommendedSessionCapUsd":"5.01","publicMetrics":"aggregate-only","buyerLevelDataPublic":false,"agentCorePaymentsCompatibleSellerSurface":true,"officialAwsCoinbaseEndorsementClaimed":false,"sourceUrls":{"coinbase":"https://www.coinbase.com/blog/introducing-amazon-bedrock-agentcore-payments-powered-by-x402-and-coinbase","aws":"https://aws.amazon.com/blogs/machine-learning/agents-that-transact-introducing-amazon-bedrock-agentcore-payments-built-with-coinbase-and-stripe/"},"guardrails":["Seller-side import metadata only","Zero-contact and inbound-only","No official AWS, Coinbase, or Stripe endorsement claim","No AWS wallet integration added by ApexScout","No automatic buyer spending","No scraping","No third-party discovery","No outreach automation","No manual messages, posts, DMs, or emails","No paid upstream calls","No fake traction","No buyer-level public data","No settlement rail change","No seller wallet change"]},"paths":{"/api/opportunity-check":{"post":{"tags":["paid-x402"],"operationId":"apexscoutOpportunityCheck","summary":"Run the cheapest ApexScout paid trust check.","description":"First paid route for buyer agents. Send an unpaid request first to receive HTTP 402 JSON, then retry with buyer-controlled x402 payment only if authorized.","x-x402":{"protocol":"x402","rail":"Base mainnet","network":"eip155:8453","price":"$0.01","maxAmountAtomicUnits":"10000","expectedUnpaidStatus":402,"expectedPaidStatus":200,"buyerWalletManagedBy":"AgentCore Payments or another buyer-controlled x402 client","sellerWalletPublicInSpec":false},"x-apexscout-guardrails":["Seller-side import metadata only","Zero-contact and inbound-only","No official AWS, Coinbase, or Stripe endorsement claim","No AWS wallet integration added by ApexScout","No automatic buyer spending","No scraping","No third-party discovery","No outreach automation","No manual messages, posts, DMs, or emails","No paid upstream calls","No fake traction","No buyer-level public data","No settlement rail change","No seller wallet change"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["subject","goal"],"properties":{"subject":{"type":"string","description":"Service, API, company, route, or opportunity to evaluate."},"goal":{"type":"string","description":"The buyer-agent decision this check should support."},"buyerType":{"type":"string","description":"Optional buyer segment, such as agentcore-buyer-agent."},"source":{"type":"string","description":"Optional source tag for aggregate attribution."}}}}}},"responses":{"200":{"description":"Paid trust check response.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string"},"recommendation":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"commercial":{"type":"object"},"trustProfile":{"type":"object"}}}}}},"402":{"description":"Unpaid x402 payment challenge. Buyer-controlled clients should inspect this before any paid retry.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error","accepts"],"properties":{"error":{"type":"string","const":"payment_required"},"accepts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string","const":"eip155:8453"},"amount":{"type":"string","const":"10000"},"price":{"type":"string","const":"$0.01"}}}}}}}}}}}},"/api/agent-revenue-audit":{"post":{"tags":["paid-x402"],"operationId":"apexscoutAgentRevenueAudit","summary":"Run the ApexScout builder monetization audit.","description":"Builder-facing $5 route for x402/API monetization strategy. This stays protected by x402 and does not make paid upstream calls.","x-x402":{"protocol":"x402","rail":"Base mainnet","network":"eip155:8453","price":"$5.00","maxAmountAtomicUnits":"5000000","expectedUnpaidStatus":402,"expectedPaidStatus":200,"buyerWalletManagedBy":"AgentCore Payments or another buyer-controlled x402 client","sellerWalletPublicInSpec":false},"x-apexscout-guardrails":["Seller-side import metadata only","Zero-contact and inbound-only","No official AWS, Coinbase, or Stripe endorsement claim","No AWS wallet integration added by ApexScout","No automatic buyer spending","No scraping","No third-party discovery","No outreach automation","No manual messages, posts, DMs, or emails","No paid upstream calls","No fake traction","No buyer-level public data","No settlement rail change","No seller wallet change"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["serviceName","currentOffer","targetBuyer"],"properties":{"serviceName":{"type":"string"},"currentOffer":{"type":"string"},"targetBuyer":{"type":"string"},"currentPaymentRail":{"type":"string"},"riskTolerance":{"type":"string"},"source":{"type":"string"}}}}}},"responses":{"200":{"description":"Paid monetization audit response.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"summary":{"type":"string"},"monetizationDiagnosis":{"type":"string"},"bestFirstPaidRoute":{"type":"object"},"conversionFriction":{"type":"array","items":{"type":"string"}},"sevenDayRevenuePlan":{"type":"array","items":{"type":"string"}}}}}}},"402":{"description":"Unpaid x402 payment challenge. Buyer-controlled clients should inspect this before any paid retry.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error","accepts"],"properties":{"error":{"type":"string","const":"payment_required"},"accepts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string","const":"eip155:8453"},"amount":{"type":"string","const":"5000000"},"price":{"type":"string","const":"$5.00"}}}}}}}}}}}},"/api/agentcore-readiness":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentCoreReadiness","summary":"Read the seller-side AgentCore x402 readiness packet.","responses":{"200":{"description":"AgentCore readiness JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agentcore-payments-policy":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentCorePaymentsPolicy","summary":"Read the AgentCore Payments-style buyer-agent spend policy.","responses":{"200":{"description":"AgentCore Payments spend policy JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agentcore-buyer-start":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentCoreBuyerStart","summary":"Read the AgentCore-style buyer start path.","responses":{"200":{"description":"AgentCore buyer start JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent-spend-passport":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentSpendPassport","summary":"Read the free Agent Spend Passport capability before payment.","responses":{"200":{"description":"Agent Spend Passport capability JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent-spend-passport/prepare":{"post":{"tags":["free-readiness"],"operationId":"prepareApexScoutAgentSpendPassport","summary":"Prepare a free no-spend route, budget, privacy, and policy decision before payment.","description":"This route is free. It does not execute payment, make paid upstream calls, store buyer-level data publicly, or guarantee revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["goal"],"properties":{"buyerType":{"type":"string","enum":["buyer-agent","builder","operator","api-founder","unknown"]},"goal":{"type":"string","maxLength":640},"intendedRoute":{"type":"string","enum":["/api/opportunity-check","/api/agent-revenue-audit","unknown"]},"maxBudgetUsd":{"type":"string"},"source":{"type":"string"}}}}}},"responses":{"200":{"description":"Prepared no-spend Spend Passport decision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string","enum":["ready_to_buy","use_cheaper_route","stop"]},"recommendedRoute":{"type":"string"},"price":{"type":"string"},"maxAmountAtomicUnits":{"type":"string"},"budgetCheck":{"type":"object"},"privacyCheck":{"type":"object"},"policyCheck":{"type":"object"},"copyPastePayload":{"type":"object"}}}}}}}}},"/api/mcp-tool-pack":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutMcpToolPack","summary":"Read ApexScout MCP-style tool metadata.","responses":{"200":{"description":"MCP Tool Pack JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent-payment-alpha":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentPaymentAlpha","summary":"Read the nine-layer agent-payment alpha and safety packet.","responses":{"200":{"description":"Agent Payment Alpha Safe Layers JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402-batch-settlement":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutX402BatchSettlementReadiness","summary":"Read readiness-only x402 batch settlement metadata.","description":"This route is free. It does not enable batch settlement, escrow, off-chain voucher acceptance, settlement rail changes, seller wallet changes, or paid calls.","responses":{"200":{"description":"x402 Batch Settlement Readiness JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402-metadata-preflight":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutX402MetadataPreflight","summary":"Read free x402 metadata preflight capability metadata.","description":"This route is free. It explains how buyer agents can classify and redact x402 resource URLs, descriptions, reason strings, and payload previews before a paid retry.","responses":{"200":{"description":"x402 Metadata Preflight JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402-metadata-preflight/check":{"post":{"tags":["free-readiness"],"operationId":"checkApexScoutX402MetadataPreflight","summary":"Classify x402 payment metadata before paid retry.","description":"Free no-spend privacy preflight. Returns redacted metadata and a stop/redact/ready decision without making paid calls or returning raw payload previews.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"route":{"type":"string","enum":["/api/opportunity-check","/api/agent-revenue-audit","unknown"]},"resourceUrl":{"type":"string","maxLength":500},"paymentDescription":{"type":"string","maxLength":600},"reason":{"type":"string","maxLength":600},"payloadPreview":{"type":"object","additionalProperties":true},"source":{"type":"string","maxLength":80}}}}}},"responses":{"200":{"description":"x402 metadata privacy decision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string","enum":["ready_to_send","redact_before_payment","stop"]},"piiRisk":{"type":"string","enum":["low","medium","high"]},"privacyCheck":{"type":"object"},"policyCheck":{"type":"object"},"sanitizedMetadata":{"type":"object"}}}}}}}}},"/api/x402-proof":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutX402Proof","summary":"Read public proof that ApexScout's x402 rail has worked.","responses":{"200":{"description":"x402 proof JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/buyer-agent-challenge":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutBuyerAgentChallenge","summary":"Read the buyer-agent challenge before payment.","responses":{"200":{"description":"Buyer-agent challenge JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}}}