US College Institution Detail

US College Institution Detail
Get one standardized US college or university institution record by IPEDS UNITID, including identity, location, ownership, degree level, website, admissions, tuition, completion, enrollment, and source freshness fields when available.

Method: GET
Path: /v1/education/us/institutions/{unitId}
Demo: https://api.gugudata.io/v1/education/us/institutions/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

appkey (string, required): Application key used for request authentication.

unitId (integer, required): IPEDS UNITID of the institution to retrieve.

Response Fields:

dataStatus (object, required): Response metadata returned by the current v1 contract.

data.unitId (integer, required): IPEDS UNITID.

data.institutionName (string, required): Institution name.

data.city (string, optional): Institution city when available.

data.state (string, required): US state abbreviation.

data.website (string, optional): Institution website when available.

data.ownership (string, optional): Institution ownership category when available.

data.degreeLevel (string, optional): Institution degree level when available.

data.admissionRate (number, optional): Admission rate when available.

data.tuitionInState (number, optional): In-state tuition when available.

data.sourceYear (integer, required): Source data year.

data.sourceUpdatedAt (string, optional): Source update timestamp.

HTTP Status Codes:

200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.

400: Invalid request parameters or request format. Check required fields, data types, and request body format.

401: Missing or unknown application key. Provide a valid appkey with the request.

403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.

429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.

500: Internal service error. Retry later or contact support if the error persists.

503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

100 Request successful: No additional remark.

101 Invalid request parameters: No additional remark.

110 Internal server error: No additional remark.

Key Features:

Retrieve a single institution record by a stable IPEDS UNITID.

Use the detail endpoint after search results to show a school profile page.

Return standardized school identity, location, website, tuition, admission, and source freshness fields when available.

Combine with the institution programs request to list fields of study for the same school.

Details:
https://gugudata.io/details/us-college-institutions

Request

Request Code Samples

Responses