---
title: "List Bounties"
method: GET
path: "/bounties"
tags: ["Bounties"]
---

# List Bounties

`GET /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.

## Query parameters

- `account_id` string
- `user_id` string
- `status` 'scheduled' | 'open' | 'closed' | 'completed' | 'canceled'
- `query` string
- `created_after` string
- `created_before` string
- `order` 'created_at' | 'gross_paid_out_amount'
- `direction` 'asc' | 'desc'
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

bounties listed

- object
  - `data` BountyListItem[], required
    - `accepted_deliverable_types` string[], required
    - `accepted_submissions_count` integer, required — Submissions accepted so far.
    - `accepted_submissions_limit` integer, required — Number of submissions that can be accepted (winner slots).
    - `affiliate_share_amount` number, required — What a referrer earns per accepted submission when the worker arrived through their affiliate link, in whole currency units, at the standard platform fee rate. Taken out of the worker's post-fee reward rather than added on top. `0` when the bounty pays no affiliate share, including bounties tied to no account, which cannot record a referral.
    - `allowed_country_codes` string[], required
    - `budget_amount` number, required — Total gross budget committed to the bounty: `gross_reward_amount` times `accepted_submissions_limit`.
    - `business_goal_type` 'clipping' | 'post_engagement' | 'owned_account_growth' | 'ugc_content' | 'local_activation' | 'data_capture' | 'other' | 'null', nullable, required — What the poster wants the work to achieve, declared once at create. `null` for bounties created before the taxonomy rolled out.
    - `cancel_requested_at` string, nullable, required — When cancellation was requested, as an ISO 8601 timestamp. On a `closed` bounty this means the cancel is pending: submissions are stopped and the bounty cancels once in-flight submissions resolve. On a `canceled` bounty it records when the cancellation was requested. `null` when no cancellation was ever requested.
    - `created_at` string, required — When the bounty was created, as an ISO 8601 timestamp.
    - `currency` string, required — Currency for all amounts on the bounty, as a lowercase ISO 4217 code.
    - `experience_id` string, nullable, required — Experience the bounty is hosted in, prefixed `exp_`. `null` for platform-wide bounties; may belong to a different account than the funder.
    - `funding_account` AccountSummary, required
      - `id` string, required — Account ID, prefixed `biz_`.
      - `title` string, required — Account display name.
    - `gross_paid_out_amount` number, required — Gross amount paid out from the bounty pool across accepted submissions — worker payouts, platform fees, and affiliate shares together. Tips and reviewer rewards are excluded.
    - `gross_reward_amount` number, required — Gross bounty-pool amount allocated per accepted submission, in whole currency units.
    - `id` string, required — Bounty ID, prefixed `bnty_`.
    - `net_reward_amount` number, required — What a worker is quoted per accepted submission after the platform fee, in whole currency units. The exact post-fee figure, at the standard platform fee rate — a worker who locked a different rate, or who arrived through an affiliate link, is paid a different amount.
    - `poster` UserSummary, required
      - `id` string, required — User ID, prefixed `user_`.
      - `name` string, nullable, required — Display name.
      - `profile_picture` UserProfilePicture, required
        - `url` string, required — Avatar image URL. Always present — a generated placeholder when the user set no picture.
      - `username` string, required — Public username.
    - `scheduled_frequency` 'once' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'null', nullable, required — How often the schedule creates a new bounty. Each occurrence is a separate bounty; the original is not republished.
    - `scheduled_publish_at` string, nullable, required — When a scheduled bounty will publish, as an ISO 8601 timestamp. `null` once published, for bounties that were never scheduled, and for terminally failed drafts parked for manual rescheduling.
    - `spots_remaining` integer, required — Unfilled winner capacity: `accepted_submissions_limit` minus `accepted_submissions_count`, clamped to zero. Not a signal that the bounty currently accepts new claims.
    - `status` 'scheduled' | 'open' | 'closed' | 'completed' | 'canceled', required — Lifecycle state. `scheduled` bounties are unpublished drafts, visible to their poster and the account's authorized managers; `open` bounties accept new submissions; `closed` bounties are live but no longer accept new submissions; `completed` bounties paid out every winner slot; `canceled` bounties ended before filling their slots.
    - `submissions_closed_at` string, nullable, required — When new submissions stopped being accepted, as an ISO 8601 timestamp. Set when a cancellation is requested on a bounty with work in flight, so in-flight submissions can resolve before the bounty cancels. `null` when submissions were never stopped — including completed bounties that simply filled every winner slot.
    - `title` string, required — Short name of the task shown to workers.
    - `unresolved_submissions_count` integer, required — Submissions still awaiting an outcome: in progress or pending review.
    - `updated_at` string, required — When the bounty was last updated, as an ISO 8601 timestamp.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)