List Pentests

List and query pentests.

External Documentation

To learn more, visit the Cobalt documentation.

​

Basic Parameters

Parameter	Description
Organization ID	The ID of the organization the assets belong to. Can be obtained by the List Organizations action.
State	Returns pentests that match the chosen state.
Testing Type	Returns pentests that match the chosen Testing Type.

​

Advanced Parameters

Parameter	Description
Asset ID	Returns pentests scoped to this asset id. Can be obtained by the List Assets action.
Cursor	Specifies the pagination cursor for the next page.
Ended after	Returns pentests that ended after the given date.
Ended before	Returns pentests that ended before the given date.
Limit	Number of results per page, valid range is 1-100.
Platform Tag	Returns pentests with specified platform tags. Multiple tags can be specified by a comma separated list.
Sort	Returns pentests sorted by chosen property.
Started after	Returns pentests that started after the given date.
Started before	Returns pentests that started before the given date.

​

Example Output

{
	"data": [
		{
			"resource": {
				"id": "pt_JQJpAAMjyc8sVtXW2X2Aq5",
				"title": "HR System Security Test 2022-Q4",
				"objectives": "Coverage of OWASP top 10, ASVS and application logic.",
				"state": "new",
				"tag": "#PT5940",
				"asset_id": "as_4L4ZjKgfzP7VBwUmqCZmmL",
				"testing_type": "agile",
				"platform_tags": [
					"rails",
					"ruby",
					"aws"
				],
				"methodology": "web",
				"targets": [
					"https://cobalt.io",
					"192.168.1.1"
				],
				"start_date": "Dec 11 2019",
				"end_date": "Dec 25 2019"
			},
			"links": {
				"ui": {
					"url": "https://api.us.cobalt.io/links/eyJ0eXBlIjoic29tZXRoaW5nIiwib3JnU2x1ZyI6ImNvYmFsdCIsInBlbnRlc3RUYWciOiJz="
				}
			}
		}
	],
	"pagination": {
		"next_page": "/pentests?cursor=a1b2c3d4",
		"prev_page": "/pentests?cursor=4d3c2b1a"
	}
}