Get a list of submissions with optional filtering.
External DocumentationTo learn more, visit the Bugcrowd documentation.

Basic Parameters

ParameterDescription
AssigneesA comma-separated list of assignees to filter submissions by. Use either an email address or the keywords me or none.
IncludeSpecify which optional data fields to include in the response.
LimitThe maximum number of results to return per page.
OffsetThe starting position for paginated results.
Return All PagesAutomatically fetch all resources, page by page.
SearchFilter submissions by searching through title, description and comment text.
SeverityA comma-seperated list of severities to filter submissions by.
SortSort the returned data.
SourceFilter submissions by source.

Advanced Parameters

ParameterDescription
Activity FieldsSpecify which optional data fields to include in the activity property of each record.
Blocked ByFilter submissions by blocked_by.
Bugcrowd VersionUsed to test new API versions before updating the pinned account version.
CVSS Vector FieldsSpecify which optional data fields to include in the cvss_vector property of each record.
Claim Ticket FieldsSpecify which optional data fields to include in the claim_ticket property of each record.
Comment FieldsSpecify which optional data fields to include in the comment property of each record.
Duplicate FilterSelect to filter submissions by duplicate.
Engagement Brief FieldsSpecify which optional data fields to include in the engagement_brief property of each record.
Engagement CodesA comma-seperated list of engagement codes to filter submissions by.
Engagement FieldsSpecify which optional data fields to include in the engagement property of each record.
Events FieldsSpecify which optional data fields to include in the event property of each record.
External Issue FieldsSpecify which optional data fields to include in the external_issue property of each record.
File Attachment FieldsSpecify which optional data fields to include in the file_attachment property of each record.
Identity FieldsSpecify which optional data fields to include in the identity property of each record.
Monetary RewardSpecify which optional data fields to include in the monetary_reward property of each record.
Organization FieldsSpecify which optional data fields to include in the organization property of each record.
Payment FieldsSpecify which optional data fields to include in the payment property of each record.
PaymentsFilter submissions by payment information.
PointsFilter submissions by points.
Program FieldsSpecify which optional data fields to include in the program property of each record.
ProgramsA comma-seperated list of program codes to filter submissions by.
Researchers FilterA comma-seperated list of researcher to filter submissions by.
Retest FilterFilter submissions by retest.
StateFilter submissions by state.
Submission FieldsSpecify which optional data fields to include in the submission property of each record.
Submitted TimestampFilter submissions by submitted timestamp.
Target FieldsSpecify which optional data fields to include in the target property of each record.
Target Group FieldsSpecify which optional data fields to include in the target_group property of each record.
Target TypeFilter submissions by target_type.
TargetsA comma-seperated list of target names to filter submissions by.
Updated TimestampFilter submissions by updated timestamp.
VRT IDFilter submissions by a dot separated VRT ID.

Example Output

{
	"data": [
		{
			"id": "10000000-0000-0000-0000-000000000000",
			"type": "submission",
			"attributes": {
				"state": "new",
				"duplicate": false
			},
			"relationships": {
				"assignees": {
					"$ref": "https://bugcrowd.com/openapi/2025-04-23/external_elements.yml#/general_helpers/EmptyManyRelationship"
				}
			},
			"links": {
				"self": "/submissions/20000000-0000-0000-0000-000000000000"
			}
		}
	],
	"included": [
		{
			"id": {
				"$ref": "https://bugcrowd.com/openapi/2025-04-23/external_elements.yml#/general_helpers/ValidUUID"
			},
			"type": "program",
			"attributes": {
				"code": "code"
			},
			"relationships": {
				"organization": {
					"data": {
						"id": {
							"$ref": "https://bugcrowd.com/openapi/2025-04-23/external_elements.yml#/general_helpers/ValidUUID"
						},
						"type": "organization"
					},
					"links": {
						"related": {
							"href": "/organizations/10000000-0000-0000-0000-000000000000"
						}
					}
				}
			},
			"links": {
				"self": "/programs/10000000-0000-0000-0000-000000000000"
			}
		}
	],
	"meta": {
		"total_hits": 1,
		"count": 1
	},
	"links": {
		"self": "/submissions?fields[activity]=key,submission&fields[claim_ticket]=status,claimed_at&fields[comment]=body,author&fields[cvss_vector]=version,score&fields[engagement]=cancellation_reason,code,ends_at,expected_completed_at,last_transition_at,paused_reason,starts_at,state,created_at,updated_at&fields[engagement_brief]=additional_information,collaboration_enabled,coordinated_disclosure,crowdstream_visible,description,name,safe_harbor_status,share_known_issues,tagline,targets_overview&fields[event]=created_at,key,data&fields[external_issue]=remote_url,remote_id,resource,integration&fields[file_attachment]=file_name,download_url&fields[identity]=name,email&fields[monetary_reward]=formatted_amount,cancelled_at&fields[organization]=name,programs&fields[payment]=amount_cents,monetary_reward&fields[program]=code,organization&fields[submission]=state,duplicate,assignees&fields[target]=name,category&fields[target_group]=name,in_scope&filter[assignees]=me,none,user@example.com&filter[severity]=1,2&include=program&page[limit]=50&page[offset]=0&sort=submitted-asc,severity-desc",
		"next": "/submissions?fields[activity]=key,submission&fields[claim_ticket]=status,claimed_at&fields[comment]=body,author&fields[cvss_vector]=version,score&fields[engagement]=cancellation_reason,code,ends_at,expected_completed_at,last_transition_at,paused_reason,starts_at,state,created_at,updated_at&fields[engagement_brief]=additional_information,collaboration_enabled,coordinated_disclosure,crowdstream_visible,description,name,safe_harbor_status,share_known_issues,tagline,targets_overview&fields[event]=created_at,key,data&fields[external_issue]=remote_url,remote_id,resource,integration&fields[file_attachment]=file_name,download_url&fields[identity]=name,email&fields[monetary_reward]=formatted_amount,cancelled_at&fields[organization]=name,programs&fields[payment]=amount_cents,monetary_reward&fields[program]=code,organization&fields[submission]=state,duplicate,assignees&fields[target]=name,category&fields[target_group]=name,in_scope&filter[assignees]=me,none,user@example.com&filter[severity]=1,2&include=program&page[limit]=50&page[offset]=50&sort=submitted-asc,severity-desc",
		"previous": "/submissions?fields[activity]=key,submission&fields[claim_ticket]=status,claimed_at&fields[comment]=body,author&fields[cvss_vector]=version,score&fields[engagement]=cancellation_reason,code,ends_at,expected_completed_at,last_transition_at,paused_reason,starts_at,state,created_at,updated_at&fields[engagement_brief]=additional_information,collaboration_enabled,coordinated_disclosure,crowdstream_visible,description,name,safe_harbor_status,share_known_issues,tagline,targets_overview&fields[event]=created_at,key,data&fields[external_issue]=remote_url,remote_id,resource,integration&fields[file_attachment]=file_name,download_url&fields[identity]=name,email&fields[monetary_reward]=formatted_amount,cancelled_at&fields[organization]=name,programs&fields[payment]=amount_cents,monetary_reward&fields[program]=code,organization&fields[submission]=state,duplicate,assignees&fields[target]=name,category&fields[target_group]=name,in_scope&filter[assignees]=me,none,user@example.com&filter[severity]=1,2&include=program&page[limit]=50&page[offset]=0&sort=submitted-asc,severity-desc"
	}
}

Workflow Library Example

List Submissions with Bugcrowd and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop