Enumerations
Every enum below uses the exact string the API returns and accepts. Many are sentence-cased with spaces (e.g. Early-stage startup) rather than snake-case — that's intentional and matches the labels members see.
UserTier
Drives freemium gating. Set on a user with tier on POST /v1/users.
| Value | Description |
|---|---|
free | Free tier user (default) |
premium | Premium tier user |
UserType
A user's startup/lifecycle stage. Stored on a user as an array (user_types[]) so a single user can carry multiple stages.
| Value |
|---|
Idea stage |
Early-stage startup |
Growth-stage startup |
Scale-up |
SME |
AudienceRegion
Geographic region. Stored on a user as an array (regions[]). Named regions, not ISO country codes.
| Value |
|---|
North America |
South America |
Europe |
Middle East |
Asia |
Africa |
Oceania |
DealTier
Filters deals visible to a user based on the user's UserTier when freemium is enabled.
| Value |
|---|
free |
premium |
DealTag
Display tags shown on deal cards. A deal can have multiple tags.
| Value |
|---|
new |
featured |
exclusive |
popular |
premium |
free |
limited_time |
best_for_startups |
ending_soon |
DealStatus
Lifecycle state of a deal.
| Value |
|---|
draft |
live |
expired |
paused |
coming_soon |
DealType
Distinguishes global vs. partner-owned deals.
| Value | Description |
|---|---|
founderpass | Curated by FounderPass; visible to every partner unless excluded |
partner_private | Created by a partner via POST /v1/partner-deals; defaults to draft, and only the owning partner's users see it after it is published with status: "live" |
PartnerType
The kind of organization a partner is. Used with include_partner_type / exclude_partner_type visibility rules.
| Value |
|---|
VC fund |
Accelerator |
Incubator |
Startup program |
Coworking space |
University |
Student society |
Startup community |
B2B platform |
Agency or consultancy |
Influencer |
Event/Conference |
Media/Newsletter/Publisher |
Government |
Bank |
Other |
DeliveryMethod
How a partner surfaces deals to their members.
| Value | Description |
|---|---|
hosted | FounderPass-hosted full-page app at your subdomain |
iframe | Embeddable widget via <iframe> |
api | Direct API integration (you build the UI) |
EventType
Valid values for event_type on POST /events/track.
| Value | When to fire |
|---|---|
deal_list_viewed | Deal appeared in a listing the user saw |
deal_detail_viewed | User opened the deal detail page |
instructions_viewed | User opened the redemption instructions |
redeem_url_clicked | User clicked the redeem CTA |
promo_code_copied | User copied the promo code |
unique_code_claimed | User claimed a one-time code |
deal_redeemed | User completed redemption |
upgrade_cta_clicked | User clicked a tier-upgrade CTA |
deal_inquiry_submitted | User filled the "request access" form |
RuleType
Valid values for rule_type on a visibility rule. Every type has both an include_* and exclude_* variant.
| Value | rule_value contains |
|---|---|
include_partner / exclude_partner | Partner UUIDs |
include_partner_type / exclude_partner_type | PartnerType values |
include_region / exclude_region | AudienceRegion values |
include_user_type / exclude_user_type | UserType values |