List Submissions - BlinkOps Documentation

Get a list of submissions with optional filtering.

External DocumentationTo 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,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"
	}
}