# Programmatic Purchase - SMB Sales Boost API

Purchase a subscription entirely via API - no web signup or onboarding required. This is ideal for AI agents and automated workflows that need programmatic access to SMB Sales Boost.

### How It Works

(1) Call `POST /api/v1/purchase` with your email and desired plan → (2) Complete payment at the returned Stripe Checkout URL → (3) Call `POST /api/v1/claim-key` with your email and claim token to retrieve your API key. Your API key is also emailed to you automatically.

### Step 1: Initiate Purchase

`POST /api/v1/purchase`

Create a new subscription purchase session. Returns a Stripe Checkout URL and a claim token. No authentication required. Rate limited to 5 requests per hour per IP.

Parameters: email (required, string), plan (required, string - "starter", "growth", "scale", "platinum", or "enterprise").

### Step 2: Complete Payment

Open the `checkoutUrl` in a browser to complete payment on Stripe's hosted checkout page. After successful payment, the system automatically provisions your account and generates an API key.

### Step 3: Claim Your API Key

`POST /api/v1/claim-key`

Retrieve your API key after payment is completed. No authentication required. Rate limited to 30 requests per hour per IP. If payment is still processing, returns a pending status - poll every 5-10 seconds.

Parameters: email (required, string - email used during purchase), claimToken (required, string - claim token from the purchase response).

### Account Setup (Highly Recommended)

Programmatic purchases skip the onboarding wizard. To get the most out of SMB Sales Boost, configure your account via the API before searching or exporting leads:

1. `PATCH /api/v1/me` \- Set your company name and website
2. `POST /api/v1/ai/suggest-categories` \- Get AI-powered category suggestions
3. `POST /api/v1/ai/generate-keywords` \- Generate targeting keywords
4. `POST /api/v1/settings/switch-database` \- Select your lead database

---

### API Documentation Sections

[Introduction](/docs/api/introduction) | **Programmatic Purchase** | [Authentication](/docs/api/authentication) | [Rate Limits](/docs/api/rate-limits) | [User Profile](/docs/api/user-profile) | [Leads](/docs/api/leads) | [Filter Presets](/docs/api/filter-presets) | [Keyword Lists](/docs/api/keyword-lists) | [Email Schedules](/docs/api/email-schedules) | [Export Formats](/docs/api/export-formats) | [Export History](/docs/api/export-history) | [Account Settings](/docs/api/account-settings) | [AI Features](/docs/api/ai-features) | [Export Blacklist](/docs/api/export-blacklist) | [Error Handling](/docs/api/error-handling) | [Credits & Subscription](/docs/api/credits-subscription) | [MCP Server](/docs/api/mcp-server) | [Integrations](/docs/api/integrations)

[View Full API Documentation](/docs/api)

---

**Ready to Find Your Next Customers?** Get access to newly registered business leads updated every 5 minutes. [Get Started](/?utm%5Fsource=content&utm%5Fmedium=cta)