# ListFindingsResponse

- [JSON representation](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#SCHEMA_REPRESENTATION)
- [ListFindingsResult](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#ListFindingsResult)
  - [JSON representation](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#ListFindingsResult.SCHEMA_REPRESENTATION)
- [StateChange](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#StateChange)
- [Resource](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#Resource)
  - [JSON representation](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#Resource.SCHEMA_REPRESENTATION)

Response message for listing findings.

| JSON representation |
|---|
| ``` { "listFindingsResults": [ { object (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#ListFindingsResult`) } ], "readTime": string, "nextPageToken": string, "totalSize": integer } ``` |

| Fields ||
|---|---|
| `listFindingsResults[]` | ``object (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#ListFindingsResult`)`` Findings matching the list request. |
| `readTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Time used for executing the list request. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `nextPageToken` | `string` Token to retrieve the next page of results, or empty if there are no more results. |
| `totalSize` | `integer` The total number of findings matching the query. |

## ListFindingsResult

Result containing the Finding and its StateChange.

| JSON representation |
|---|
| ``` { "finding": { object (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/organizations.sources.findings#Finding`) }, "stateChange": enum (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#StateChange`), "resource": { object (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#Resource`) } } ``` |

| Fields ||
|---|---|
| `finding` | ``object (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/organizations.sources.findings#Finding`)`` Finding matching the search request. |
| `stateChange` | ``enum (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#StateChange`)`` State change of the finding between the points in time. |
| `resource` | ``object (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/ListFindingsResponse#Resource`)`` Output only. Resource that is associated with this finding. |

## StateChange

The change in state of the finding.

When querying across two points in time this describes the change in the finding between the two points: CHANGED, UNCHANGED, ADDED, or REMOVED. Findings can not be deleted, so REMOVED implies that the finding at timestamp does not match the filter specified, but it did at timestamp - compareDuration. If there was no compareDuration supplied in the request the state change will be: UNUSED

| Enums ||
|---|---|
| `UNUSED` | State change is unused, this is the canonical default for this enum. |
| `CHANGED` | The finding has changed state in some way between the points in time and existed at both points. |
| `UNCHANGED` | The finding has not changed state between the points in time and existed at both points. |
| `ADDED` | The finding was created between the points in time. |
| `REMOVED` | The finding at timestamp does not match the filter specified, but it did at timestamp - compareDuration. |

## Resource

Information related to the Google Cloud resource that is associated with this finding.

| JSON representation |
|---|
| ``` { "name": string, "projectName": string, "projectDisplayName": string, "parentName": string, "parentDisplayName": string, "folders": [ { object (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/Folder`) } ] } ``` |

| Fields ||
|---|---|
| `name` | `string` The full resource name of the resource. See: <https://cloud.google.com/apis/design/resource_names#full_resource_name> |
| `projectName` | `string` The full resource name of project that the resource belongs to. |
| `projectDisplayName` | `string` The project id that the resource belongs to. |
| `parentName` | `string` The full resource name of resource's parent. |
| `parentDisplayName` | `string` The human readable name of resource's parent. |
| `folders[]` | ``object (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1p1beta1/Folder`)`` Contains a Folder message for each folder in the assets ancestry. The first folder is the deepest nested folder, and the last folder is the folder directly under the Organization. |