US College Institution Programs

US College Institution Programs
List standardized program and field-of-study records for a specific US college or university institution by IPEDS UNITID.

Method: GET
Path: /v1/education/us/institutions/{unitId}/programs
Demo: https://api.gugudata.io/v1/education/us/programs/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.

keyword (string, optional): Keyword for program or CIP title.

pageIndex (integer, optional): One-based page index for pagination.

pageSize (integer, optional): Number of records returned per page.

sort (string, optional): Sort expression in field|direction format.

Response Fields:

dataStatus.dataTotalCount (integer, required): Total number of records that match the request.

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

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

data[].cipCode (string, required): CIP code.

data[].programName (string, required): Program or field-of-study name.

data[].credentialLevel (string, optional): Credential level.

data[].medianEarnings (number, optional): Median earnings when available.

data[].medianDebt (number, optional): Median debt 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:

List fields of study for one institution by IPEDS UNITID.

Support school profile pages that need related program data.

Return standardized CIP code, program name, credential level, tuition, earnings, debt, and source freshness fields when available.

Combine with the US College Programs Data API for broader program search across institutions.

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Request

Request Code Samples

Responses