---
title: "POST /domains/{domainId}/cases/{caseId}/audit-history"
method: POST
path: "/domains/{domainId}/cases/{caseId}/audit-history"
---

# POST /domains/{domainId}/cases/{caseId}/audit-history

`POST /domains/{domainId}/cases/{caseId}/audit-history`

Returns the audit history about a specific case if it exists.

## Path parameters

- `caseId` string, required
- `domainId` string, required

## Request body

- object
  - `maxResults` integer — The maximum number of audit events to return. When no value is provided, 25 is the default.
  - `nextToken` string — The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

## Response `200`

Success

- GetCaseAuditEventsResponse
  - `nextToken` string — The token for the next set of results. This is null if there are no more results to return.
  - `auditEvents` AuditEvent[], required — A list of case audits where each represents a particular edit of the case.
    - `eventId` string, required — Unique identifier of a case audit history event.
    - `type` 'Case.Created' | 'Case.Updated' | 'RelatedItem.Created' | 'RelatedItem.Deleted' | 'RelatedItem.Updated', required — <p>The type of audit history event.</p> <p>Valid Values: <code>Case.Created</code> | <code>Case.Updated</code> | <code>RelatedItem.Created</code> | <code>RelatedItem.Updated</code> | <code>RelatedItem.Deleted</code> </p>
    - `relatedItemType` 'Contact' | 'Comment' | 'File' | 'Sla' | 'ConnectCase' | 'Custom' — The Type of the related item.
    - `performedTime` string, date-time, required — Time at which an Audit History event took place.
    - `fields` AuditEventField[], required — A list of Case Audit History event fields.
      - `eventFieldId` string, required — Unique identifier of field in an Audit History entry.
      - `oldValue` object — Union of potential field value types.
        - `stringValue` string — Can be either null, or have a String value type. Only one value can be provided.
        - `doubleValue` number, double — Can be either null, or have a Double value type. Only one value can be provided.
        - `booleanValue` boolean — Can be either null, or have a Boolean value type. Only one value can be provided.
        - `emptyValue` EmptyFieldValue — <p>An empty value. You cannot set <code>EmptyFieldValue</code> on a field that is required on a case template.</p> <p>This structure will never have any data members. It signifies an empty value on a case field.</p>
        - `userArnValue` string — Can be either null, or have a String value type formatted as an ARN. Only one value can be provided.
      - `newValue` object, required — Union of potential field value types.
        - `stringValue` string — Can be either null, or have a String value type. Only one value can be provided.
        - `doubleValue` number, double — Can be either null, or have a Double value type. Only one value can be provided.
        - `booleanValue` boolean — Can be either null, or have a Boolean value type. Only one value can be provided.
        - `emptyValue` EmptyFieldValue — <p>An empty value. You cannot set <code>EmptyFieldValue</code> on a field that is required on a case template.</p> <p>This structure will never have any data members. It signifies an empty value on a case field.</p>
        - `userArnValue` string — Can be either null, or have a String value type formatted as an ARN. Only one value can be provided.
    - `performedBy` object — Information of the user which performed the audit.
      - `user` UserUnion — Represents the entity that performed the action.
        - `userArn` string — Represents the Amazon Connect ARN of the user.
        - `customEntity` string, password — Any provided entity.
      - `iamPrincipalArn` string, required — Unique identifier of an IAM role.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ValidationException
- `483` — ThrottlingException
- `484` — AccessDeniedException

---

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