Case data status change

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

{
  "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.

​Payload example

​CaseDataEvent eventObject properties

Payload example

`CaseDataEvent` eventObject properties