Researcher Documentation

Welcome to the researcherdocs developer hub. You'll find comprehensive guides and documentation to help you start working with researcherdocs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

Filtering Submissions

You can use filters to view submissions that match a particular set of criteria. For example, you can query submissions that you may need to follow up on, such as ones that have been identified as valid but have not been paid out yet.

To filter your submissions, you create a query using filter keys

Filter Keys

Filter keys narrow your submissions down to a specific set of results.

The following filter keys and possible values are available:

Key
Value
Notes

payments

none or present

Returns submissions based on if they have payments set.

points

none or present

Returns submissions based on whether points have been assigned.

program

Matches on the Bounty code that is present in the URL path, such as bugcrowd, mastercard, etc.

Supports negative search.

program-status

live, closed, or invited

Returns submissions based on their program status.

severity

1-5, none or present

Matches the severity assigned to the submission.

sort

updated, points, created, or payment

Can append -asc or -desc depending on how you want it to be sorted.

state

new, triaged, wont-fix, not-applicable, out-of-scope, unresolved, and resolved

Matches the current program state.

Supports negative search.

target

Matches on the target name.

Supports negative search.

target-type

website, api, mobile, iot, ios, android, hardware, or other

Matches the target type.

Filter Syntax

To create a query, you need to use the following syntax: <filter key>:<value>.

Make sure you include a colon after the filter key and do not include any spaces between the filter key and value.

You can enter multiple filter key/value pairs in the query, such as: state:new program:bugcrowd.

By default, the query includes sort:submitted-desc, which sorts your submissions in descending order based on the dates they were submitted. You can remove or replace this filter key/value.

Filter Logic

There is an AND operator between unique filter keys; however, multiple instances of the same filter key use the OR operator. For example, state:new state:triaged program:bugcrowd returns all submissions that have a state of either triaged or new and is part of the Bugcrowd program.

Negative Search

Certain filters allow negative search, which allows you to find values that do not meet the specified value. You can think of a negative search like a blacklist. To perform a negative search, add a - before the key, like -state:triaged.

You can perform a negative search with the following filter keys: state, program, and target.

Building a Query

To help you build a submissions query, a list of available filter keys will appear when you click in the search field. After you select a filter key, the search field will show you possible values based on what you've selected.

Remember, you can use as many key/value combinations you need, and there is an AND operator between unique filter keys and an OR operator between multiple instances of the same filter key.

As you add filter key/value pairs to the query, the results automatically refresh to show you the latest results.

Note

If you input an invalid filter key or query, no submissions will be returned. Please review your queries for any errors if the results do not show the submissions you expect to see.

Preset Queries

There are preset queries available that let you quickly find submissions that are pending, have been accepted, have been are duplicates. Just click on the filter and the query will display in the search field.

The following preset queries are available:

Query
Filters
Description

Pending

state:new state:triaged

Finds new submissions that have been triaged.

Accepted

state:unresolved state:resolved

Shows submissions that have a resolved or unresolved status.

No Reward

state:wont-fix state:out-of-scope state:not-applicable state:not-reproducible

Returns submissions that have been rejected.

Duplicate

state:duplicate

Looks for submissions that have been marked as a duplicate.

Filtering Submissions