# Certn API Documentation

> Source: https://centric-api-docs.certn.co/#check-DIGITAL_REFERENCE_CHECKS_1

### Digital Reference Checks

**Digital Reference Checks**

**Identifier:** `DIGITAL_REFERENCE_CHECKS_1`

A Digital Reference Check gathers information about an applicant's personal character, reliability, and past work performance directly from their nominated referees. Referees receive an online questionnaire via email, featuring either a preset or custom list of questions tailored to your organisation's hiring needs. Their responses are collected digitally and returned in a clear, concise report. Referees receive a maximum of one email reminder per day for five days (a total of five reminders) starting the day after the initial invitation. The system allows 14 days for responses — after which, the check will expire and the questionnaire link will no longer be valid.

**Ordering methods:** Invite

**Note:** This check is ordered via invite or through a parent check. Applicant data is collected via the invite form and is not sent in the API request body.

### Child Checks

| Check | Description | Via parent only | Docs |
|-------|-------------|------------------|------|
| `DIGITAL_REFERENCE_CHECK_1` | A Digital Reference Check gathers information about an applicant's personal character, reliability, and past work performance directly from their nominated referees. Referees receive an online questionnaire via email, featuring either a preset or custom list of questions tailored to your organisation's hiring needs. Their responses are collected digitally and returned in a clear, concise report. Referees receive a maximum of one email reminder per day for five days (a total of five reminders) starting the day after the initial invitation. The system allows 14 days for responses — after which, the check will expire and the questionnaire link will no longer be valid. | Yes | [Open](https://centric-api-docs.certn.co/#check-DIGITAL_REFERENCE_CHECK_1) |

Full details and **Try it** for each child: [`DIGITAL_REFERENCE_CHECK_1`](https://centric-api-docs.certn.co/#check-DIGITAL_REFERENCE_CHECK_1)

### Response

**201 Created** — Successfully ordered. Use the returned `id` to retrieve the full case via `GET /api/public/cases/{id}/`.

### Error codes

| Status | Type | Description |
|--------|------|-------------|
| 400 | `validation_error` | Invalid request data |
| 401 | `client_error` | Authentication failed |
| 403 | `client_error` | Permission denied |
| 422 | `validation_error` | Request validation failed (e.g. missing required fields) |