Skip to main content

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​

API keys are issued by FounderPass per partner account. Get in touch through the contact form to be onboarded — you'll receive a public key and a private key.

:::warning Keep your private key secret The private key is shown once at creation and rotated on demand. Do not commit it to a repository, ship it in client-side code, or paste it into shared logs. If exposed, regenerate immediately from the Partner Portal. :::

:::tip Build against sandbox first Your account also has a test key pair (pk_test_… / sk_test_…) backed by an isolated sandbox. Use it to build and verify your integration without touching live data — see Testing in sandbox. :::

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