> ## Documentation Index
> Fetch the complete documentation index at: https://developer.karmacheck.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Case data status change

> Webhook event payload and properties for the casedata.statuschange event.

The `casedata.statuschange` event is sent to the webhook whenever the status of a service changes.

Note that additional events can occur even after a service reaches a completion status. For instance, you might receive a notification when a service is complete, then receive a subsequent webhook indicating that the status of the service changed back to pending due to a review or adjudication.

## Payload example

```json theme={null}
{
  "messageId": "3d054561-e6ea-c877-3201-57256af6f1ef",
  "event": "casedata.statuschange",
  "apiTrackingCode": null,
  "apiTrackingUser": null,
  "eventObject": {
    "id": "2f209172-e2df-4b78-a644-c950554fd5f8",
    "description": "SSN Trace",
    "caseId": "3edec2585-29fd-4e85-ae5f-b251d1007ecd",
    "storageId": "def2d21d-d1a2-331dd-a4fg-dsb3aeddf713",
    "details": {},
    "serviceId": "29cd44ab-a8f0-4b27-868e-dc4be88ff541",
    "serviceName": "SSN Trace",
    "serviceTypeId": "30bc2c03-c8dd-409a-8da6-e0070ea6a681",
    "serviceTypeName": "Screening",
    "statusId": "8f29e0de-10f2-4c84-8379-16c6eb7cdf64",
    "status": "pending",
    "pendingStatusId": null,
    "pendingStatus": null,
    "crStamp": "2024-05-25T19:16:55.000Z",
    "modStamp": "2024-05-25T19:18:11.000Z",
    "groupProfileId": "dd2346e4-ed17-2c66-ce22-06ae7e372fd2",
    "candidateId": "fe2d4d28-229b-4f4d-c1d6-fbedcb189275",
    "candidateEmail": "lee@example.com",
    "secondaryStatusId": null,
    "secondaryStatus": null,
    "dataKey": null,
    "serviceCategoryId": "service-cat-idv",
    "serviceCategory": "Identity Verification",
    "serviceSubCategoryId": null,
    "serviceSubCategory": null,
    "serviceProviderId": "ddeab230-db41-245b-af22-1d2e24dfb139"
  }
}
```

## `CaseDataEvent` eventObject properties

| Property | Type | Required | Description |
| - | - | - | - |
| `id` | `string` | `Required` | Unique identifier of the case data record. |
| `description` | `string` | `Required` | Description associated with the service for this case data record. |
| `caseId` | `string` | `Required` | Case ID. |
| `storageId` | `string` | `Required` | Storage ID for the case data record. |
| `details` | `object` | `Required` | Service-specific details object; fields vary by service type. |
| `serviceId` | `string` | `Required` | Service ID represented by the case data record. |
| `serviceName` | `string` | `Required` | Service name. |
| `serviceTypeId` | `string` | `Required` | Service type ID. |
| `serviceTypeName` | `string` | `Required` | Service type name. |
| `statusId` | `string` | `Required` | Case data status ID. |
| `status` | `string` | `Required` | Case data status name. |
| `pendingStatusId` | `string \| null` | `Required` | Pending status ID, when present. |
| `pendingStatus` | `string \| null` | `Required` | Pending status name, when present. |
| `crStamp` | `string` | `Required` | Creation timestamp. |
| `modStamp` | `string` | `Required` | Last modified timestamp. |
| `groupProfileId` | `string` | `Required` | Group profile ID. |
| `candidateId` | `string` | `Required` | Candidate ID. |
| `candidateEmail` | `string` | `Required` | Candidate email. |
| `secondaryStatusId` | `string \| null` | `Required` | Secondary status ID, when present. |
| `secondaryStatus` | `string \| null` | `Required` | Secondary status name, when present. |
| `dataKey` | `string \| null` | `Required` | Optional service-specific data key. |
| `serviceCategoryId` | `string` | `Required` | Service category ID. |
| `serviceCategory` | `string` | `Required` | Service category name. |
| `serviceSubCategoryId` | `string \| null` | `Required` | Service subcategory ID, when present. |
| `serviceSubCategory` | `string \| null` | `Required` | Service subcategory name, when present. |
| `serviceProviderId` | `string` | `Required` | Service provider ID. |