Purdue Directory API

JSON search over Purdue's public directory app.

Live demo

Classification
Campus

Reference

Routes

RoutePurpose
GET /This page: demo + reference.
GET /apiRoute index, JSON.
GET /healthCircuit pool, cache, uptime.
GET /searchSearch the directory.

GET /search parameters

ParamRule
q Required. 3–100 characters, trimmed.
classification Repeatable. faculty or staff. Undergrad/grad need a Purdue login; rejected with 400.
campus Repeatable. West Lafayette, Indianapolis, Northwest, Fort Wayne. Case-insensitive.
department Substring match, ≤100 characters.

Values in one group OR together. Groups AND together.

Response fields

FieldMeaning
queryTrimmed q actually searched.
filtersValidated, deduplicated filters requested.
totalRow count from upstream. 100 means at least 100 — no pagination.
cappedtrue when total is exactly 100.
appliedFiltersParsed from upstream's "Filtering by" banner. Proof the filters took effect.
people[]name, plus title, department, campus, classification, email, phone when present.
cachedtrue if served from this server's cache.
tookMsRequest time, end to end.

Errors

StatusWhen
400Bad q, classification, campus, or department.
404Unknown route.
502Circuit or upstream search failed.
503Upstream rate limit hit. Retry-After header, seconds.

Every response carries X-Request-Id. Successful searches carry Cache-Control: public, max-age=600.

Examples

curl 'https://your-host/search?q=smith'
curl 'https://your-host/search?q=smith&classification=faculty&classification=staff&campus=West%20Lafayette'
curl 'https://your-host/search?q=an'  # 400