{ "openapi": "3.1.0", "info": { "title": "Universities API", "version": "1.0.0", "description": "6,273 US colleges with admission rate, tuition, net price, completion, debt and earnings, plus 10,240 world universities.\n\nEvery US college and university with the numbers families and edtech products actually need — straight from the Department of Education's College Scorecard (June 2026 release): 6,273 institutions with admission rate and average SAT, undergraduate enrollment, in-state and out-of-state tuition, average net price, completion rate, median student debt and median earnings ten years after entry, plus ownership type, degree levels, locale and coordinates. Ask real questions in one call: the most selective schools (Caltech at 2.6%), California publics ranked by graduate earnings, bachelor's programs under a tuition cap, or any campus's full profile (Harvard: 3.65% admission, SAT 1553, 97.6% completion, $101,817 median earnings). A per-state rollup and a 10,240-entry worldwide university directory (names, countries, official domains and websites — ideal for email-domain matching and signup validation) round it out. Public-domain US data, refreshed with each Scorecard release. Built for edtech, student-loan and scholarship tools, rankings sites, CRM enrichment and market research. Self-hosted — no third-party calls at request time.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/universities.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/universities" }, "servers": [ { "url": "https://api-universities.dataandapis.com" } ], "tags": [ { "name": "Education", "description": "Universities API belongs to the Education category of the Data and APIs catalog." } ], "paths": { "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Universities API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/universities/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 2, "sources": [ { "slug": "hipolabs", "name": "Hipolabs university domains list", "publisher": "Hipolabs (github.com/Hipo/university-domains-list)", "licence": "MIT", "source_url": "https://github.com/Hipo/university-domains-list", "file_url": "https://raw.githubusercontent.com/Hipo/university-domains-list/master/world_universities_and_domains.json", "cadence": "community-maintained", "record_count": 10240, "retrieved_at": "2026-09-03" }, { "slug": "college-scorecard", "name": "US Dept of Education College Scorecard", "publisher": "US Department of Education", "licence": "US Government work - public domain", "source_url": "https://collegescorecard.ed.gov/data", "file_url": null, "cadence": "1-2 releases per year", "record_count": 6273, "retrieved_at": "2026-09-03" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/universities/{unitid}": { "get": { "operationId": "getInstitution", "summary": "Get Institution", "description": "Get Institution endpoint of the Universities API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/universities/get-institution" }, "parameters": [ { "name": "unitid", "in": "path", "required": true, "schema": { "type": "string" }, "example": "166027" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "institution": { "unitid": 166027, "name": "Harvard University", "alias": "NA", "location": { "city": "Cambridge", "state": "MA", "zip": "02138", "locale": "city", "latitude": 42.3745, "longitude": -71.1183 }, "url": "https://www.harvard.edu/", "ownership": "private-nonprofit", "degrees": { "predominant": "bachelor", "highest": "graduate" }, "admissions": { "rate": 0.0365, "sat_avg": 1553 }, "enrollment": 7601, "cost": { "tuition_in_state": 61676, "tuition_out_state": 61676, "avg_net_price": 19066 }, "outcomes": { "completion_rate": 0.9758, "median_earnings_10y": 101817, "median_debt": 14000 }, "operating": true } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/universities": { "get": { "operationId": "searchUsInstitutions", "summary": "Search US Institutions", "description": "Search US Institutions endpoint of the Universities API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/universities/search-us-institutions" }, "parameters": [ { "name": "degree", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "max_admission_rate", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "max_tuition", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "min_earnings", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operating", "in": "query", "required": false, "schema": { "type": "string" }, "example": "true" }, { "name": "ownership", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Harvard" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" }, "example": "earnings" }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "total": 1, "page": 1, "limit": 20, "count": 1, "results": [ { "unitid": 166027, "name": "Harvard University", "city": "Cambridge", "state": "MA", "ownership": "private-nonprofit", "enrollment": 7601, "admission_rate": 0.0365, "tuition_out_state": 61676, "median_earnings_10y": 101817 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/universities/states": { "get": { "operationId": "statesRollup", "summary": "States Rollup", "description": "States Rollup endpoint of the Universities API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/universities/states-rollup" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 5, "states": [ { "state": "CA", "institutions": 658, "enrollment": 2133495 }, { "state": "NY", "institutions": 417, "enrollment": 800099 }, { "state": "TX", "institutions": 410, "enrollment": 1240605 }, { "state": "FL", "institutions": 374, "enrollment": 855408 }, { "state": "PA", "institutions": 317, "enrollment": 468960 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/world": { "get": { "operationId": "worldUniversities", "summary": "World Universities", "description": "World Universities endpoint of the Universities API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/universities/world-universities" }, "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "50" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Oxford" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "total": 2, "page": 1, "limit": 50, "count": 2, "results": [ { "id": 8399, "name": "Oxford Brookes University", "country": "United Kingdom", "alpha_2": "GB", "state_province": null, "domains": [ "brookes.ac.uk" ], "web_pages": [ "http://www.brookes.ac.uk/" ] }, { "id": 8478, "name": "University of Oxford", "country": "United Kingdom", "alpha_2": "GB", "state_province": null, "domains": [ "oxford.ac.uk", "ox.ac.uk" ], "web_pages": [ "http://www.ox.ac.uk/" ] } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }