List Bounties

JavaScript

import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const bountyListItem of client.bounties.list()) {
  console.log(bountyListItem.id);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/bounties",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/bounties"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/bounties")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "accepted_deliverable_types": [
        "content_url"
      ],
      "accepted_submissions_count": 0,
      "accepted_submissions_limit": 1,
      "accepted_submissions_per_user_limit": 1,
      "affiliate_share_amount": 2.1,
      "allowed_country_codes": [
        "US"
      ],
      "budget_amount": 15,
      "business_goal_type": "clipping",
      "cancel_requested_at": "2026-01-01T12:00:00.000Z",
      "created_at": "2026-01-01T12:00:00.000Z",
      "currency": "usd",
      "description": "Bounty Description",
      "discussion_experience_id": "<string>",
      "discussion_feed_id": "<string>",
      "discussion_post_id": "<string>",
      "experience_id": "exp_xxxxxxxxxxxxxx",
      "funding_account": {
        "id": "biz_xxxxxxxxxxxxxx",
        "title": "Shine Time Auto Detailing"
      },
      "gross_paid_out_amount": 0,
      "gross_reward_amount": 15,
      "id": "bnty_xxxxxxxxxxxxxx",
      "net_reward_amount": 10.5,
      "poster": {
        "id": "user_xxxxxxxxxxxxxx",
        "name": "Dana Whitfield",
        "profile_picture": {
          "url": "https://ui-avatars.com/api/"
        },
        "username": "danawhitfield"
      },
      "scheduled_frequency": "once",
      "scheduled_publish_at": "2026-01-01T12:00:00.000Z",
      "spots_remaining": 1,
      "status": "open",
      "submissions_closed_at": "2026-01-01T12:00:00.000Z",
      "title": "Photograph the storefront",
      "unresolved_submissions_count": 1,
      "updated_at": "2026-01-01T12:00:00.000Z",
      "viewer_accepted_submissions_count": 0
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "has_next_page": false,
    "has_previous_page": false,
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

GET

bounties

JavaScript

import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const bountyListItem of client.bounties.list()) {
  console.log(bountyListItem.id);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/bounties",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/bounties"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/bounties")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "accepted_deliverable_types": [
        "content_url"
      ],
      "accepted_submissions_count": 0,
      "accepted_submissions_limit": 1,
      "accepted_submissions_per_user_limit": 1,
      "affiliate_share_amount": 2.1,
      "allowed_country_codes": [
        "US"
      ],
      "budget_amount": 15,
      "business_goal_type": "clipping",
      "cancel_requested_at": "2026-01-01T12:00:00.000Z",
      "created_at": "2026-01-01T12:00:00.000Z",
      "currency": "usd",
      "description": "Bounty Description",
      "discussion_experience_id": "<string>",
      "discussion_feed_id": "<string>",
      "discussion_post_id": "<string>",
      "experience_id": "exp_xxxxxxxxxxxxxx",
      "funding_account": {
        "id": "biz_xxxxxxxxxxxxxx",
        "title": "Shine Time Auto Detailing"
      },
      "gross_paid_out_amount": 0,
      "gross_reward_amount": 15,
      "id": "bnty_xxxxxxxxxxxxxx",
      "net_reward_amount": 10.5,
      "poster": {
        "id": "user_xxxxxxxxxxxxxx",
        "name": "Dana Whitfield",
        "profile_picture": {
          "url": "https://ui-avatars.com/api/"
        },
        "username": "danawhitfield"
      },
      "scheduled_frequency": "once",
      "scheduled_publish_at": "2026-01-01T12:00:00.000Z",
      "spots_remaining": 1,
      "status": "open",
      "submissions_closed_at": "2026-01-01T12:00:00.000Z",
      "title": "Photograph the storefront",
      "unresolved_submissions_count": 1,
      "updated_at": "2026-01-01T12:00:00.000Z",
      "viewer_accepted_submissions_count": 0
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "has_next_page": false,
    "has_previous_page": false,
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Api-Version-Date

string

Pins the request to a dated API version.

Example:

"2026-08-21"

Query Parameters

account_id

string

Scope the list to this account (biz_ tag). Requires read access to the account; account API keys may pass their own account or a connected account.

user_id

string

List the bounties this user participated in (user_ tag). Must be the authenticated user.

status

enum<string>

Filter by lifecycle state.

Available options:

scheduled,

open,

closed,

completed,

canceled

business_goal_type

enum<string>

Filter by the poster's declared goal. Bounties created before the goal taxonomy carry no goal and never match this filter.

Available options:

clipping,

post_engagement,

owned_account_growth,

ugc_content,

local_activation,

data_capture,

other

country

string

Only bounties workable from this country, as an ISO 3166-1 alpha-2 code. Bounties with no country targeting are workable worldwide and always match.

experience_id

string

Only bounties posted to this forum experience, prefixed exp_. An unknown experience, or one outside the caller's scope, matches nothing.

query

string

Substring match on the bounty title or ID.

created_after

string

Only bounties created after this ISO 8601 timestamp.

created_before

string

Only bounties created before this ISO 8601 timestamp.

order

enum<string>

default:created_at

Sort field.

Available options:

created_at,

gross_paid_out_amount,

gross_reward_amount

direction

enum<string>

default:desc

Sort direction.

Available options:

asc,

desc

first

integer

default:20

Number of bounties to return from the start of the window.

Required range: x <= 100

after

string

Cursor to paginate forwards from.

last

integer

Number of bounties to return from the end of the window.

Required range: x <= 100

before

string

Cursor to paginate backwards from.

Response

bounties listed

data

object[]

required

Show child attributes

page_info

object

required

Show child attributes

⌘I

Introduction

Reference

Webhooks & events

Core Resources

Notifications

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Authorizations

Headers

Query Parameters

Response