Sign in
Bounties

List Bounties

Lists bounties visible to the credential — for an account API key, the account's bounties including scheduled drafts; for a user token, the bounties the user can see and work.

get/bounties

Query parameters

account_idstring

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_idstring

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

status'scheduled' | 'open' | 'closed' | 'completed' | 'canceled'

Filter by lifecycle state.

business_goal_type'clipping' | 'post_engagement' | 'owned_account_growth' | 'ugc_content' | 'local_activation' | 'data_capture' | 'other'

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

countrystring

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_idstring

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

querystring

Substring match on the bounty title or ID.

created_afterstring

Only bounties created after this ISO 8601 timestamp.

created_beforestring

Only bounties created before this ISO 8601 timestamp.

order'created_at' | 'gross_paid_out_amount' | 'gross_reward_amount'

Sort field.

direction'asc' | 'desc'

Sort direction.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

bounties listed

Example response

{
  "data": [
    {
      "accepted_deliverable_types": [
        "content_url"
      ],
      "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",
      "experience_id": "exp_xxxxxxxxxxxxxx",
      "funding_account": {
        "id": "biz_xxxxxxxxxxxxxx",
        "title": "Shine Time Auto Detailing"
      },
      "gross_reward_amount": 15,
      "hosting_account": {
        "id": "biz_xxxxxxxxxxxxxx",
        "logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "route": "shine-time-auto-detailing",
        "title": "Shine Time Auto Detailing"
      },
      "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"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes