OI
owner-partners

API Reference

All 73 API endpoints for the Owner Partners affiliate management platform.

Tracking

POST
/api/track/referral

Track referral click (requires X-API-Key)

POST
/api/track/conversion

Track conversion/sale with referral fee calculation

External API

POST
/api/external/referrals

Create referral via external API (rate limited)

GET
/api/external/leads/[id]/status

Get lead/referral status

Authentication

POST
/api/auth/login

Login with email/password

DELETE
/api/auth/login

Logout (clear auth cookie)

POST
/api/auth/register

Register new affiliate

GET
/api/auth/me

Get current user info

POST
/api/auth/me

Get current user profile

POST
/api/auth/send-otp

Send OTP

POST
/api/auth/verify-otp

Verify OTP

POST
/api/auth/verify-email

Verify email address

POST
/api/auth/resend-verification

Resend verification email

POST
/api/auth/forgot-password

Request password reset

POST
/api/auth/reset-password

Reset password with token

GET
/api/auth/google

Initiate Google OAuth

GET
/api/auth/google/callback

Google OAuth callback

Affiliate Endpoints

GET
/api/affiliate/profile

Get affiliate profile with stats

PUT
/api/affiliate/profile

Update affiliate profile

POST
/api/affiliate/change-email

Change email address

POST
/api/affiliate/change-password

Change password

POST
/api/affiliate/generate-code

Generate referral code

GET
/api/affiliate/referrals

List own referrals

POST
/api/affiliate/send-referral

Send referral message

GET
/api/affiliate/payouts

View payout history

POST
/api/affiliate/send-sms

Send referral SMS (rate limited: 10/hr per user)

POST
/api/affiliate/onboarding

Onboarding flow

GET
/api/affiliate/resources

Marketing resources

POST
/api/affiliate/branding

Get program branding

POST
/api/affiliate/stripe

Initiate Stripe Connect onboarding

POST
/api/affiliate/stripe/update

Update Stripe Connect account

Admin - Affiliates

GET
/api/admin/affiliates

List all affiliates with pagination

POST
/api/admin/affiliates

Create new affiliate

GET
/api/admin/affiliates/[id]

Get affiliate details

POST
/api/admin/affiliates/[id]

Update affiliate

POST
/api/admin/affiliates/batch

Batch affiliate operations

Admin - Referral Fees & Payouts

POST
/api/admin/commissions/approve

Approve pending referral fees

GET
/api/admin/payouts

List payouts

POST
/api/admin/payouts

Create manual payout

POST
/api/admin/payouts/auto

Auto payout settings

GET
/api/admin/refunds

List refunds

GET
/api/admin/transactions

List transactions

GET
/api/admin/invoices

List invoices

Admin - Referrals

GET
/api/admin/referrals

List all referrals

POST
/api/admin/referrals

Create/update referral

GET
/api/admin/referrals/[id]

Get referral details

Admin - Dashboard & Reports

GET
/api/admin/dashboard

Main dashboard stats (revenue, conversions, performance)

GET
/api/admin/analytics

Analytics data

GET
/api/admin/reports

Generate reports

POST
/api/admin/reports/email

Email report to recipients

GET
/api/admin/reports/cohort

Cohort analysis

GET
/api/admin/saved-reports

Saved report templates

GET
/api/admin/scheduled-reports

Scheduled reports

Admin - Marketing & Email

GET
/api/admin/emails

List email templates

POST
/api/admin/emails

Create email template

POST
/api/admin/emails/test

Send test email

GET
/api/admin/marketing/campaigns

List campaigns

POST
/api/admin/marketing/campaigns

Create campaign

POST
/api/admin/marketing/campaigns/send

Send campaign to audience

POST
/api/admin/marketing/campaigns/test-send

Test send campaign

GET
/api/admin/marketing/campaigns/templates

Get campaign templates

GET
/api/admin/marketing/analytics

Campaign analytics (opens, clicks, bounces)

GET
/api/admin/marketing/contacts

Marketing contact list

POST
/api/admin/marketing/contacts

Add marketing contact

Admin - Settings & Configuration

GET
/api/admin/profile

Get admin profile

GET
/api/admin/settings/profile

Get profile settings

POST
/api/admin/settings/profile

Update profile settings

POST
/api/admin/settings

Update program settings

GET
/api/admin/settings/integration

Get integration settings

POST
/api/admin/settings/integration

Update integration settings

GET
/api/admin/integration

Get integration config

POST
/api/admin/integration

Configure integration

POST
/api/admin/integration/generate-key

Generate API key

GET
/api/admin/api-keys

List API keys

POST
/api/admin/api-keys

Create API key

GET
/api/admin/api-usage

API usage stats

GET
/api/admin/webhooks

List webhooks

POST
/api/admin/webhooks

Create webhook

Admin - Other

GET
/api/admin/team

List team members

GET
/api/admin/partner-groups

List partner groups

POST
/api/admin/partner-groups

Create partner group

GET
/api/admin/coupons

List coupons

GET
/api/admin/resources

List resources

Webhooks

POST
/api/webhook/stripe

Stripe webhook handler (payments, connect)

POST
/api/webhook/conversion

Conversion webhook events

POST
/api/webhook/resend-marketing

Resend marketing webhook (open/click/bounce)

Cron / Automation

POST
/api/cron/payouts

Scheduled payout processing

POST
/api/cron/marketing

Marketing automation tasks

POST
/api/cron/partner-reengagement

Re-engagement for inactive partners

Public & Utility

GET
/api/health

Health check (database connectivity)

GET
/api/public/programs

Public program info

POST
/api/notifications

Get user notifications

POST
/api/unsubscribe

Unsubscribe from emails

POST
/api/test/email

Test email endpoint