# Certn API Documentation - Ordering Case

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

## Ordering a Case

There are two methods to order a Case:

### Method 1: Invite (Recommended)

Send an invitation to the applicant to complete their information themselves.

#### Option A: Certn sends the email

```bash
POST /api/public/cases/order/
{
  "email_address": "applicant@example.com",
  "send_invite_email": true,
  "check_types_with_arguments": {
    "IDENTITY_VERIFICATION_1": {}
  }
}
```

#### Option B: You deliver the invite link yourself

Set return_invite_link to true to receive the invitation URL in the response. You can then deliver this link to the applicant via your own channels (e.g. your own email, SMS, or in-app notification).

```bash
POST /api/public/cases/order/
{
  "email_address": "applicant@example.com",
  "send_invite_email": false,
  "return_invite_link": true,
  "check_types_with_arguments": {
    "IDENTITY_VERIFICATION_1": {}
  }
}
```

**Benefits:**
- Applicant provides their own information (higher accuracy)
- Built-in consent collection
- No need to collect sensitive data yourself

### Method 2: Quickscreen

Provide all applicant information upfront. No applicant interaction is required. To use Quickscreen, send_invite_email must be false and return_invite_link must be false (or omitted).

```bash
POST /api/public/cases/order/
{
  "email_address": "applicant@example.com",
  "send_invite_email": false,
  "return_invite_link": false,
  "check_types_with_arguments": {
    "IDENTITY_VERIFICATION_1": {}
  },
  "input_claims": {
    "name": {"given_name": "John", "family_name": "Doe"},
    "date_of_birth": "1990-01-15",
    "residences": [{
      "address": {
        "street_address": "123 Main St",
        "locality": "Vancouver",
        "administrative_division_1": "BC",
        "postal_code": "V6B 1A1",
        "country": "CA"
      },
      "start_date": "2020-01-01"
    }]
  }
}
```

**Requirements:**
- Must provide all required `input_claims` for the selected checks
- Check must support Quickscreen ordering (see Checks Catalog)
- You are responsible for collecting consent from the applicant
- `send_invite_email` must be `false` and `return_invite_link` must be `false` (or omitted)

---

## 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*