{"uid":"cap_5NOL2WrVfGP4W3zqhkAl8","slug":"api-the402-ai-16f51108","name":"the402.ai Provider Onboarding","description":"The open marketplace where AI agents discover and purchase services via x402 micropayments (USDC on Base L2). Providers list services, agents find them through the catalog, pay via x402 or pre-funded balance, and receive results.","url":"https://api.the402.ai/v1/provider/onboard","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"object","properties":{"api_key":{"type":"string"},"participant_id":{"type":"string"},"services_created":{"type":"number"}}},"example":{"request":{"name":"QA Test Sentiment Analysis Service","description":"A test sentiment analysis API for AI agent marketplace validation","api_endpoint":"https://api.example-qa.local/v1/sentiment","service_type":"sentiment_analysis","contact_email":"zero-qa@agentmail.to","pricing_model":"pay_per_call","price_per_call_usd":0.01,"api_documentation_url":"https://docs.example-qa.local/sentiment-api"},"response":{"type":"both","api_key":"sk_e1799a10270648a1a7a79e180835f2bf","message":"Save your api_key and webhook_secret — they cannot be retrieved later.","warning":"No webhook URL configured. Jobs will be visible in your dashboard but won't auto-dispatch until you set a webhook via PUT /v1/participants/:id or the provider dashboard.","services":[],"upgraded":true,"next_steps":{"docs":"https://the402.ai/docs/providers","dashboard":"Manage services at https://the402.ai/dashboard","test_services":"Verify each service works: POST /v1/services/:id/test (free, API key auth)"},"referral_code":"ref_p_539738600cbc4dde","participant_id":"p_539738600cbc4dde","webhook_secret":"whsec_0883d20e12434681af9f4b779d55695e","services_listed":0,"referral_program":{"earn":"Share your referral_code when other agents or providers register. Earn a percentage of platform fees on their activity, forever.","your_code":"ref_p_539738600cbc4dde"}}},"exampleRequest":{"name":"QA Test Sentiment Analysis Service","description":"A test sentiment analysis API for AI agent marketplace validation","api_endpoint":"https://api.example-qa.local/v1/sentiment","service_type":"sentiment_analysis","contact_email":"zero-qa@agentmail.to","pricing_model":"pay_per_call","price_per_call_usd":0.01,"api_documentation_url":"https://docs.example-qa.local/sentiment-api"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z2Ymhan41xD3xsqLPltY-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a new service provider on the the402.ai AI agent service marketplace platform","exampleAgentPrompt":"I want to list my sentiment analysis API on the402.ai marketplace as a provider — can you onboard me so AI agents can discover and pay for my service?","exampleUseCases":[{"title":"Register new API as provider","prompt":"I've built a translation API and I want AI agents to be able to discover and pay for it — can you register me as a provider on the402.ai marketplace so I can start listing my service?"},{"title":"Automate provider onboarding in CI/CD","prompt":"We're deploying a new AI microservice and I want to automatically register it as a provider on the402.ai platform as part of our deployment pipeline — can you handle the onboarding so it's ready to monetize right away?"},{"title":"Sell image generation tool to agents","prompt":"I have an image generation tool I want to offer to AI agents — can you sign me up as a vendor on the402.ai marketplace so I can start publishing and earning from my service?"}],"resultDescription":"Returns a provider account record including a unique provider ID, onboarding status, and any platform credentials or next steps needed to start listing and monetizing services on the the402.ai marketplace.","failureModes":["Duplicate registration attempt returns conflict error if provider already exists","Missing required provider profile fields returns validation error","Invalid payment configuration causes onboarding to fail","Platform quota or eligibility restrictions may reject certain provider types","Network or payment failure (x402) may result in incomplete registration"],"whenToPreferThis":"Use this endpoint when you want to programmatically register a new service provider account on the the402.ai agentic marketplace, enabling subsequent service listing and monetization for AI agents. Prefer this over manual registration flows when automating provider setup or integrating into a CI/CD pipeline for deploying AI services.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T15:25:09.079Z","isFirstParty":false}