API Reference
Base URL: https://api.partner-forge.com/api/v1
Auth: Authorization: Bearer YOUR_API_KEY
Format: JSON
Rate limits: Growth 100 req/min, Scale 500 req/min
Programs
POST /programs
Create a new program.
GET /programs
List all your programs.
GET /programs/:id
Get program details.
PATCH /programs/:id
Update program settings.
DELETE /programs/:id
Archive a program.
Affiliates
GET /programs/:id/affiliates
List affiliates in a program. Query: ?status=approved|pending|rejected
POST /programs/:id/affiliates
Invite an affiliate by email. Body: { "email": "..." }
PATCH /affiliates/:id
Update affiliate status or custom rate. Body: { "status": "approved", "customRate": 25 }
Conversions
GET /conversions
List conversions. Query: ?status=pending|approved|rejected&page=1&limit=50
GET /conversions/:id
Conversion detail with fraud signals.
POST /conversions/:id/approve
Approve a held conversion.
POST /conversions/:id/reject
Reject a conversion (reverses commission).
Commissions
GET /commissions
List commissions. Query: ?status=pending|approved|paid&page=1&limit=50
GET /commissions/summary
Aggregate commission stats (counts and amounts by status).
Webhooks
POST /webhooks
Register a webhook endpoint. Body: { "url": "https://...", "events": ["conversion.created", ...] }
GET /webhooks
List registered webhooks.
DELETE /webhooks/:id
Remove a webhook endpoint.