> ## Documentation Index > Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt > Use this file to discover all available pages before exploring further. # List Submissions Get a list of submissions with optional filtering. External Documentation To learn more, visit the [Bugcrowd documentation](https://docs.bugcrowd.com/api/1.0.0/#tag/submission_resource/operation/listSubmissions). ## 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 ```json theme={"dark"} { "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](https://library.blinkops.com/workflows/list-submissions-with-bugcrowd-and-send-results-via-email)
Workflow Library Preview this Workflow on desktop