List attestations

get

https://cloud.tenable.com/pci-asv/attestations/list

Returns a list of PCI attestations in PCI ASV.

Note: You need to request access to this endpoint through Tenable support even if you have a valid PCI ASV license.

Requires the Administrator [64] user role. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

status_type

array of strings

Filters the list of PCI attestations by status.

To retrieve attestations that are currently in progress but have yet to be submitted for review, you can use the following status types:

IN_PROGRESS—Attestations that are in progress.
NEEDS_WORK—Attestations that require additional work.

To retrieve attestations that are currently in review, you can use the following status types:

IN_REVIEW—Attestations that are currently under review.
INFO_REQUESTED—Attestations that require additional information for one or more disputes.
INFO_PROVIDED—Attestations where you have provided additional information but the information is yet to be reviewed.

To retrieve attestations that have completed the review process, you can use the following status types:

FAILED—Attestations that have failed review.
PASSED—Attestations that have passed review.
CLOSED—Attestations that are no longer active.

status_type

sort

string

The field you want to use to sort the results by along with the sort order. The field is specified first, followed by a colon, and the order is specified second (asc or desc). For example, name:desc would sort results by the name field in descending order.

If you specify multiple fields, the fields must be separated by commas. For example, name:desc,started_at:asc would first sort results by the name field in descending order and then by the started_at field in ascending order.

limit

int32

The number of records to retrieve.

offset

int32

The starting record to retrieve. If this parameter is omitted, Tenable PCI ASV uses the default value of 0.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

403

Returned if you do not have the required permissions to view the list of attestations. For example, if you're an analyst user instead of an administrator.

200Returned if Tenable PCI ASV successfully retrieved the list of PCI attestations.

400Returned if you do not have a license to use Tenable PCI ASV.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if an internal error occurred in Tenable PCI ASV.