# Certn API Documentation - Case Lifecycle

> Source: https://centric-api-docs.certn.co/#case-lifecycle
> Interactive docs: https://centric-api-docs.certn.co/#case-lifecycle

## Case Lifecycle

Understanding how Cases and Checks progress through their lifecycle.

### Case Statuses

The overall status of the case. Before the applicant submits the case's application, the case status is the applicant status. After the applicant submits, the case status is derived from its check(s) — status descriptions are listed in order of precedence, and the first status whose conditions are met determines the case status:

| Status | Description |
|--------|-------------|
| `DRAFT` | Case has been created but not yet ordered. The applicant has not been invited |
| `CASE_ORDERED` | Case successfully created |
| `INVITE_UNDELIVERABLE` | Invite email not delivered, received bounceback |
| `APPLICANT_EXPIRED` | Applicant did not submit the case within the expiry period set by the client |
| `APPLICANT_INVITED` | Applicant received the invite email |
| `APPLICANT_OPENED` | Applicant opened the invite link, but has not yet started the application |
| `APPLICANT_STARTED` | Applicant opened the pending application |
| `APPLICANT_SUBMITTED` | Applicant submitted the case's application. Checks should now be in progress |
| `IN_DISPUTE` | At least one check for the case has been disputed |
| `IN_PROGRESS` | At least one check is in a non-"closed" state (i.e. not `COMPLETE`, `CANCELLED`, or `SUPERSEDED`); requires both applicant and client action; or at least one check has been superseded with none being `COMPLETE` |
| `APPLICANT_ACTION_REQUIRED` | At least one check for the case is marked with status `APPLICANT_ACTION_REQUIRED` |
| `CLIENT_ACTION_REQUIRED` | At least one check for the case is marked with status `CLIENT_ACTION_REQUIRED` |
| `CANCELLED` | All checks for the case have been cancelled by either applicant, client, or Certn |
| `COMPLETE` | All checks for the case are in a "closed" (i.e. `COMPLETE`, `CANCELLED`, `SUPERSEDED`) state, with at least one being `COMPLETE` |

### Check Statuses

The status of the check:

| Status | Description |
|--------|-------------|
| `AWAITING_APPLICANT_SUBMISSION` | Check successfully created and is waiting for the applicant to submit the application |
| `PENDING_FULFILLMENT` | Check is ready for fulfillment |
| `IN_PROGRESS` | Check is being fulfilled |
| `SUBMITTED_TO_SOURCE` | Check has been submitted to the provider and is awaiting results |
| `MANUAL_REVIEW_SOURCE` | Check has been submitted to the provider and is undergoing manual review |
| `CLIENT_ACTION_REQUIRED` | Check requires action from the client before proceeding |
| `APPLICANT_ACTION_REQUIRED` | Check requires additional action from the applicant before proceeding |
| `PENDING_QUALITY_REVIEW` | Check fulfillment is complete and awaiting a determination on whether compliance or quality review is required |
| `IN_QUALITY_REVIEW` | Check fulfillment is complete and is undergoing compliance or quality review |
| `CANCELLED` | Check was cancelled by itself, or because its case was cancelled or declined |
| `COMPLETE` | Check fulfillment is complete and the result is ready for client to review |
| `IN_DISPUTE` | Check fulfillment is complete, and the result was disputed |
| `SUPERSEDED` | Check was replaced by a newer check due to a re-run |

### Check Scores

The score of the check. This field is `null` until the check is closed (i.e. `COMPLETE` or `CANCELLED`):

| Score | Description |
|-------|-------------|
| `REJECT` | Check completed with results that did not meet client-defined adjudication criteria |
| `REVIEW` | Check completed with results that may require review |
| `NOT_APPLICABLE` | Scoring does not apply to this check type |
| `CLEAR` | Check completed with no issues in results |
| `RESTRICTED` | Results are restricted by Certn and not available for viewing |

---

## Additional Resources

- [Interactive Documentation](https://centric-api-docs.certn.co)
- [OpenAPI Specification](https://centric-api-docs.certn.co/openapi.yaml)
- [All Reference Docs](https://centric-api-docs.certn.co/reference/)

*Generated from Certn API Documentation*