Docs
Get in touchPartner Portal

Getting started

Base URL

The Partner API is available at:

https://perks.founderpass.com

All paths in this documentation are relative to that base URL. Production base URL is provided alongside your live API keys.

1. Get an API key pair

You manage your own API keys in the Partner Portal under API Keys. Each partner account has a public key and a private key; generate the private key yourself from that page. The recommended order is to generate your test key first for sandbox work, then your live key when you are ready for production traffic.

2. Exchange keys for a JWT

curl -X POST https://perks.founderpass.com/v1/authentications \
  -H "Content-Type: application/json" \
  -d '{
    "public_key": "pk_live_...",
    "private_key": "sk_live_..."
  }'

Response:

{
  "success": true,
  "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_at": "2026-03-27T16:00:00Z",
  "partner_id": "018e4b2a-1234-7def-abcd-000000000001"
}

Tokens are valid for 15 minutes. Cache them server-side and refresh on expiry.

3. Make your first call

List the deals available to your partner account:

curl https://perks.founderpass.com/v1/deals \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

You’ll get back a paginated list of deals, global FounderPass offers plus any partner-private deals you’ve created.

Next steps

  • Authentication, token lifecycle, rotation, header conventions
  • Errors, error envelope and status code reference
  • Guides, recipes for the most common integration patterns
  • API Reference, every endpoint, generated from our OpenAPI spec