---
title: "POST /v1/list-cases"
method: POST
path: "/v1/list-cases"
---

# POST /v1/list-cases

`POST /v1/list-cases`

Lists all cases the requester has access to.

## Request body

- object
  - `nextToken` string — An optional string that, if supplied, must be copied from the output of a previous call to ListCases. When provided in this manner, the API fetches the next page of results.
  - `maxResults` integer — Optional element for ListCases to limit the number of responses.

## Response `200`

Success

- ListCasesResponse
  - `nextToken` string — An optional string that, if supplied on subsequent calls to ListCases, allows the API to fetch the next page of results.
  - `items` ListCasesItem[] — Response element for ListCases that includes caseARN, caseID, caseStatus, closedDate, createdDate, engagementType, lastUpdatedDate, pendingAction, resolverType, and title for each response.
    - `caseId` string, required — <p/>
    - `lastUpdatedDate` string, date-time — <p/>
    - `title` string, password — <p/>
    - `caseArn` string — <p/>
    - `engagementType` 'Security Incident' | 'Investigation' — <p/>
    - `caseStatus` 'Submitted' | 'Acknowledged' | 'Detection and Analysis' | 'Containment, Eradication and Recovery' | 'Post-incident Activities' | 'Ready to Close' | 'Closed' — <p/>
    - `createdDate` string, date-time — <p/>
    - `closedDate` string, date-time — <p/>
    - `resolverType` 'AWS' | 'Self' — <p/>
    - `pendingAction` 'Customer' | 'None' — <p/>
  - `total` integer — Response element for ListCases providing the total number of responses.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — SecurityIncidentResponseNotActiveException
- `484` — InternalServerException
- `485` — ThrottlingException
- `486` — ConflictException
- `487` — ResourceNotFoundException
- `488` — InvalidTokenException

---

[API](https://skmtc.net/aws/apis/security-ir.md) · [All operations](https://skmtc.net/aws/apis/security-ir/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/security-ir/versions/e22a88ccce95/schema)