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

# Education Testing

> Sandbox scenarios for education verification — pick the student record the National Student Clearinghouse returns, by SSN or date of birth

Test education verification in sandbox by choosing which student record comes back. The last four digits of the applicant's SSN select the scenario, so you can cover completed degrees, current enrollment, past enrollment, and empty records without waiting on a real school.

<Note>
  Education verification takes no login credentials. The applicant is matched on identity, so what you set on the user decides the report — the SSN, or the date of birth when you have no SSN to send.
</Note>

***

## Quick start

Create an education order for an applicant whose SSN ends in the scenario's four digits. Either route works.

**In the Dashboard** — go to **Activity > Orders** and click **Create Order**. Enter a nine-digit SSN whose last four digits are the scenario you want, so `666-09-9916` selects `9916`, then pick Education as the product. See [Create an order](/developers/dashboard/activity#create-an-order) for the full walkthrough.

**Through the API** — call [Create Order](/api-reference/orders/orders_create):

```bash theme={null}
curl --request POST \
  --url https://prod.truv.com/v1/orders/ \
  --header 'X-Access-Client-Id: <client_id>' \
  --header 'X-Access-Secret: <access_secret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "products": ["education"],
    "external_user_id": "student-001",
    "first_name": "Jane",
    "last_name": "Doe",
    "ssn": "666-09-9916"
  }'
```

Open the `share_url` from the response to run the flow and pick a school.

To switch scenarios, order again with a different SSN.

<Note>
  To select a scenario by **date of birth** instead, [create the user](/api-reference/users/users_create) first and place the order against it. The order request has no `date_of_birth` field, so it is the one identifier you cannot set this way.
</Note>

The student's name in the report always comes from the applicant — the scenario supplies the schools, degrees, and enrollment history.

***

## How a scenario is selected

Truv compares the last four digits of the SSN against each scenario and serves the first match.

| Situation                                                     | Result                              |
| ------------------------------------------------------------- | ----------------------------------- |
| The SSN's last four match a scenario below                    | That scenario's record              |
| No SSN on the applicant, under a sandbox key                  | The default scenario — `9916` today |
| The SSN matches nothing, the date of birth matches a scenario | That scenario's record              |
| Nothing matches                                               | Order finishes with **no data**     |

The default covers an applicant you have no SSN for: Truv stamps that scenario's digits on them so the order returns a record instead of nothing. Which scenario is the default is set per environment, so confirm it before relying on the value above.

The same SSN returns the same record every time. Refreshing a verification moves the term dates forward on a few scenarios, but never changes the enrollment status it reports.

The school comes from the education provider the applicant picks, so you never pass a school code yourself.

<Tip>
  To reach these scenarios under a **production** API key, select the **Truv College (Sandbox)** provider (`truv_college`). It is flagged as a sandbox provider, so any order against it is served the records below with no call to the Clearinghouse.
</Tip>

***

## Completed degrees, no enrollment

A former student. The Clearinghouse confirms the degree but reports no enrollment, so nothing is currently in progress. Use these to check how your integration renders a graduate.

| SSN last four | Date of birth | What you get                                                              |
| ------------- | ------------- | ------------------------------------------------------------------------- |
| `9901`        | `1982-04-21`  | Bachelor of Science                                                       |
| `9902`        | `1980-12-22`  | Bachelor of Arts                                                          |
| `9903`        | `1968-04-21`  | Associate of Applied Science                                              |
| `9904`        | `1981-03-25`  | Master's                                                                  |
| `9905`        | `1964-09-06`  | PhD                                                                       |
| `9906`        | `1980-04-09`  | Doctor of Optometry                                                       |
| `9907`        | `1982-01-20`  | Certificate of Completion in Medical Technology                           |
| `9908`        | `1980-01-16`  | Two master's degrees awarded in the same term — MBA and Master of Science |
| `9909`        | `1967-05-28`  | Master of Arts and Bachelor of Arts, awarded years apart                  |
| `9910`        | `1993-07-11`  | Master of Public Health                                                   |
| `9911`        | `1991-05-27`  | Master of Science and Bachelor of Science, awarded two years apart        |

Every degree here comes back confirmed and graduated, with an award date. Degree records carry no school name, major, or honors.

***

## Current enrollment

| SSN last four | Date of birth | What you get                                                                                                                                    |
| ------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `9916`        | `1980-03-26`  | A currently enrolled student at two schools — one full time, one whose enrollment type the school withheld — plus two completed nursing degrees |

This is the only scenario that returns a current enrollment, and the only one where a self-certification requirement based on full-time study is met.

<Note>
  The Clearinghouse answers with every enrollment it holds for a student, not only the school you ordered against. `9916` returns two schools from one order, so expect a report to describe more than one institution.
</Note>

***

## Past enrollment

Enrollment the school has confirmed and closed. The enrollment type is what the school reported for the most recent term, which is what a community-engagement or full-time-study requirement is judged on.

| SSN last four | Date of birth | Enrollment type                     | Also returns                        |
| ------------- | ------------- | ----------------------------------- | ----------------------------------- |
| `9914`        | `1988-10-24`  | Withheld by the school              | Master of Arts and Bachelor of Arts |
| `9915`        | `1996-05-24`  | Less than half time, at two schools | Bachelor of Sciences                |
| `9917`        | `2001-09-23`  | Full time                           | Bachelor of Sciences                |
| `9918`        | `1985-02-10`  | Three-quarter time                  | Master of Arts                      |
| `9919`        | `1977-08-19`  | Full time                           | Master's                            |
| `9921`        | `2003-10-16`  | Withheld by the school              | —                                   |
| `9922`        | `1978-01-12`  | Full time                           | —                                   |
| `9923`        | `1994-06-20`  | Full time                           | —                                   |
| `9924`        | `1979-08-18`  | Half time, at two schools           | —                                   |
| `9925`        | `1968-02-16`  | Half time                           | —                                   |
| `9928`        | `1998-02-03`  | Full time                           | —                                   |

***

## Empty and unconfirmed records

All six finish the order with **no data**, for two different reasons. Use them to check that your integration handles a verification that returns nothing.

| SSN last four | Date of birth | Why                                                                                  |
| ------------- | ------------- | ------------------------------------------------------------------------------------ |
| `9912`        | `—`           | No education record found for the student                                            |
| `9920`        | `—`           | No education record found for the student                                            |
| `9927`        | `1999-04-09`  | No education record found for the student                                            |
| `9929`        | `2002-08-14`  | No education record found for the student                                            |
| `9913`        | `1955-09-20`  | A record was located, but the Clearinghouse could not confirm the student's identity |
| `9926`        | `1967-05-28`  | A record was located, but the Clearinghouse could not confirm the student's identity |

See [Task lifecycle](/api-reference/tasks/lifecycle) for how a no-data outcome surfaces and how to handle it.

***

## Enrollment type

The Clearinghouse reports how heavily a student was enrolled for each term, not a credit-hour count. Truv returns it as `enrollment_type` on the enrollment, taken from the most recent term.

| Reported as         | Meaning                                                                    |
| ------------------- | -------------------------------------------------------------------------- |
| Full time           | Enrolled full time                                                         |
| Three-quarter time  | At least three-quarter time, below full time                               |
| Half time           | At least half time, below three-quarter time                               |
| Less than half time | Enrolled, below half time                                                  |
| Withheld            | The school declined to report it — treat it as unknown, not as a shortfall |

An enrollment type the school withheld is not the same as a student below the bar. Scenarios `9914`, `9916` and `9921` each return a withheld enrollment type so you can tell the two apart in your own logic.
