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

Changed in 9 of the 74 revisions of this API.1113149

    • ○

      added the required property /////// to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 42 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the new optional query request parameter business_goal_type

      new-optional-request-parameter

    • ○

      added the new optional query request parameter country

      new-optional-request-parameter

    • ○

      added the new optional query request parameter experience_id

      new-optional-request-parameter

    • ○

      added the new enum value gross_reward_amount to the query request parameter order

      request-parameter-enum-value-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 60bbb4a6ffbc1113131See the full diff
    • ▲

      the query request parameter direction was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      the query request parameter status was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      for the query request parameter direction, default value desc was added

      request-parameter-default-value-added

    • ▲

      for the query request parameter first, default value 20 was added

      request-parameter-default-value-added

    • ▲

      the // response's property format changed from date-time to no format for status

      response-property-type-changed

    • ▲

      the // response's property format changed from date-time to no format for status

      response-property-type-changed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ●

      for the query request parameter first, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter last, the max was set to 100.00

      request-parameter-max-set

    • ●

      deleted the query request parameter experience_id

      request-parameter-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      added the new canceled enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new closed enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new completed enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new open enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      api operation id listBounty removed and replaced with listBounties

      api-operation-id-removed

    • ○

      the security scope bounty:basic:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      added the new optional header request parameter Api-Version-Date to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter account_id

      new-optional-request-parameter

    • ○

      added the new optional query request parameter created_after

      new-optional-request-parameter

    • ○

      added the new optional query request parameter created_before

      new-optional-request-parameter

    • ○

      added the new optional query request parameter order

      new-optional-request-parameter

    • ○

      added the new optional query request parameter query

      new-optional-request-parameter

    • ○

      added the new optional query request parameter user_id

      new-optional-request-parameter

    • ○

      added the new enum value asc to the query request parameter direction

      request-parameter-enum-value-added

    • ○

      added the new enum value canceled to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value closed to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value completed to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value desc to the query request parameter direction

      request-parameter-enum-value-added

    • ○

      added the new enum value open to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value scheduled to the query request parameter status

      request-parameter-enum-value-added

    • ○

      for the query request parameter direction, the type was generalized from no type to string

      request-parameter-type-generalized

    • ○

      for the query request parameter status, the type was generalized from no type to string

      request-parameter-type-generalized

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the aed enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the all enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the amd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the ape enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the archived enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the ars enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the aud enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the awg enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the bam enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the bgn enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the bhd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the bob enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the brl enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the bsd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the btc enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the cad enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the chf enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the clp enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the cny enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the cop enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the crc enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the czk enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the dkk enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the dop enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the dzd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the egp enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the etb enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the eth enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the eur enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the gbp enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the ghs enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the gmd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the gtq enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the gyd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the hkd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the huf enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the idr enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the ils enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the inr enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the jmd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the jod enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the jpy enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the kes enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the khr enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the krw enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the kwd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the kzt enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the lkr enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the mad enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the mdl enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the mga enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the mkd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the mnt enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the mop enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the mur enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the mxn enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the myr enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the nad enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the ngn enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the nok enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the nzd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the omr enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the pen enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the php enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the pkr enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the pln enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the published enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the pyg enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the qar enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the ron enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the rsd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the rub enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the rwf enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the sar enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the sek enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the sgd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the thb enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the tnd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the try enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the ttd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the twd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the tzs enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the usd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the usdt enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the uyu enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the uzs enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the vnd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the whop_usd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the xau enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the xcd enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the xof enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the zar enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.