Education Testing

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.

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.

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 for the full walkthrough. Through the API — call Create Order:

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.

To select a scenario by date of birth instead, create the user 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.

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.

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.

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.

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.

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

Get Started

Start Building

Implementation

Bridge SDK

Testing & Launch

Dashboard & Configuration

Coverage

Education Testing

Quick start

How a scenario is selected

Completed degrees, no enrollment

Current enrollment

Past enrollment

Empty and unconfirmed records

Enrollment type

​Quick start

​How a scenario is selected

​Completed degrees, no enrollment

​Current enrollment

​Past enrollment

​Empty and unconfirmed records

​Enrollment type

Quick start

How a scenario is selected

Completed degrees, no enrollment

Current enrollment

Past enrollment

Empty and unconfirmed records

Enrollment type