University

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-university-schema.json",
  "title": "University",
  "description": "An institution of higher learning.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/api-ninjas-com-openapi.json#/components/schemas/University",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The full name of the institution, in English."
    },
    "degree_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Degree types offered. US institutions only."
    },
    "address": {
      "type": "string",
      "description": "The street address of the institution."
    },
    "city": {
      "type": "string",
      "description": "The city where the institution is located."
    },
    "state": {
      "type": "string",
      "description": "State, province or region: a code for US and Canadian institutions (e.g., MA), the name elsewhere (e.g., Bavaria)."
    },
    "postal_code": {
      "type": "string",
      "description": "The postal/zip code of the institution."
    },
    "country": {
      "type": "string",
      "description": "USA for the US and its territories, CANADA for Canada, and the English country name elsewhere (e.g., Germany)."
    },
    "county": {
      "type": "string",
      "description": "The county where the institution is located. US institutions only."
    },
    "timezone": {
      "type": "string",
      "description": "Timezone abbreviation for US and Canadian institutions. See timezone_iana for all institutions."
    },
    "latitude": {
      "type": "string",
      "description": "Latitude of the institution, as a string."
    },
    "longitude": {
      "type": "string",
      "description": "Longitude of the institution, as a string."
    },
    "phone": {
      "type": "string",
      "description": "Contact phone number."
    },
    "email": {
      "type": "string",
      "description": "Contact email address."
    },
    "website": {
      "type": "string",
      "description": "The official website URL."
    },
    "institution_type": {
      "type": "string",
      "description": "Public, Private (Not For Profit) or Private (For Profit). Canadian institutions show a category such as University, College or Career College."
    },
    "years": {
      "type": "string",
      "description": "4 Years, 2 Years or Under 2 Years. US institutions only."
    },
    "enrollment": {
      "type": "string",
      "description": "Number of enrolled students, as a string. See enrollment_year."
    },
    "student_faculty_ratio": {
      "type": "string",
      "description": "Student-to-faculty ratio. US institutions only."
    },
    "tuition": {
      "type": "number",
      "description": "Published in-state tuition and fees for the latest academic year, in USD. US institutions only."
    },
    "id": {
      "type": "integer",
      "description": "Unique API Ninjas institution ID. Stays the same across data updates; pass it as the id parameter to fetch the institution again."
    },
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 two-letter country code."
    },
    "region_code": {
      "type": "string",
      "description": "ISO 3166-2 code of the state, province or region, without the country prefix."
    },
    "native_name": {
      "type": "string",
      "description": "The name in the local language, when it differs from name."
    },
    "aliases": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Other names: official and translated names, former names and common short forms."
    },
    "acronym": {
      "type": "string",
      "description": "The common acronym."
    },
    "domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Web and email domains used by the institution."
    },
    "founded": {
      "type": "integer",
      "description": "The year the institution was founded."
    },
    "level": {
      "type": "string",
      "enum": [
        "university",
        "college",
        "polytechnic",
        "community_college",
        "vocational",
        "specialized"
      ],
      "description": "The type of institution."
    },
    "control": {
      "type": "string",
      "enum": [
        "public",
        "private_nonprofit",
        "private_forprofit",
        "private"
      ],
      "description": "Ownership. private means private with unknown profit status."
    },
    "recognition": {
      "type": "string",
      "enum": [
        "recognized"
      ],
      "description": "Recognition status in a national education registry."
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "closed"
      ],
      "description": "closed for institutions that have stopped operating or merged into another institution."
    },
    "parent_id": {
      "type": "integer",
      "description": "The id of the parent institution, for branch campuses and constituent or affiliated colleges."
    },
    "timezone_iana": {
      "type": "string",
      "description": "The IANA timezone of the institution."
    },
    "enrollment_year": {
      "type": "integer",
      "description": "The year the enrollment figure refers to."
    },
    "tuition_in_state": {
      "type": "integer",
      "description": "Published in-state tuition and fees for the latest academic year, in USD. US institutions only."
    },
    "tuition_out_of_state": {
      "type": "integer",
      "description": "Published out-of-state tuition and fees for the latest academic year, in USD. US institutions only."
    },
    "ror_id": {
      "type": "string",
      "description": "Research Organization Registry ID."
    },
    "wikidata_id": {
      "type": "string",
      "description": "Wikidata item ID."
    },
    "research_output": {
      "type": "integer",
      "description": "Number of scholarly works affiliated with the institution, from OpenAlex."
    }
  }
}