List Submissions

Get a list of submissions with optional filtering.

External Documentation

To learn more, visit the Bugcrowd documentation.

Basic Parameters

Parameter	Description
Assignees	A comma-separated list of assignees to filter submissions by. Use either an email address or the keywords me or none.
Include	Specify which optional data fields to include in the response.
Limit	The maximum number of results to return per page.
Offset	The starting position for paginated results.
Return All Pages	Automatically fetch all resources, page by page.
Search	Filter submissions by searching through title, description and comment text.
Severity	A comma-separated list of severities to filter submissions by.
Sort	Sort the returned data.
Source	Filter submissions by source.

Advanced Parameters

Parameter	Description
Activity Fields	Specify which optional data fields to include in the activity property of each record.
Blocked By	Filter submissions by blocked_by.
Bugcrowd Version	Used to test new API versions before updating the pinned account version.
CVSS Vector Fields	Specify which optional data fields to include in the cvss_vector property of each record.
Claim Ticket Fields	Specify which optional data fields to include in the claim_ticket property of each record.
Comment Fields	Specify which optional data fields to include in the comment property of each record.
Duplicate Filter	Select to filter submissions by duplicate.
Engagement Brief Fields	Specify which optional data fields to include in the engagement_brief property of each record.
Engagement Codes	A comma-separated list of engagement codes to filter submissions by.
Engagement Fields	Specify which optional data fields to include in the engagement property of each record.
Events Fields	Specify which optional data fields to include in the event property of each record.
External Issue Fields	Specify which optional data fields to include in the external_issue property of each record.
File Attachment Fields	Specify which optional data fields to include in the file_attachment property of each record.
Identity Fields	Specify which optional data fields to include in the identity property of each record.
Monetary Reward	Specify which optional data fields to include in the monetary_reward property of each record.
Organization Fields	Specify which optional data fields to include in the organization property of each record.
Payment Fields	Specify which optional data fields to include in the payment property of each record.
Payments	Filter submissions by payment information.
Points	Filter submissions by points.
Program Fields	Specify which optional data fields to include in the program property of each record.
Programs	A comma-separated list of program codes to filter submissions by.
Researchers Filter	A comma-separated list of researcher to filter submissions by.
Retest Filter	Filter submissions by retest.
State	Filter submissions by state.
Submission Fields	Specify which optional data fields to include in the submission property of each record.
Submitted Timestamp	Filter submissions by submitted timestamp.
Target Fields	Specify which optional data fields to include in the target property of each record.
Target Group Fields	Specify which optional data fields to include in the target_group property of each record.
Target Type	Filter submissions by target_type.
Targets	A comma-separated list of target names to filter submissions by.
Updated Timestamp	Filter submissions by updated timestamp.
VRT ID	Filter 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,[e-mail]&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,[e-mail]&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,[e-mail]&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

Preview this Workflow on desktop